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NEW AND CHANGED INFORMATION 
Revision of March 1971 

This manual has been extensively revised to increase technical 
accuracy, incorporate new material resulting from the develop- 
ment of the 5.03 release of the monitor, and improve overall 
presentation of technical information. The location of new or 
changed technical information is indicated by a black vertical 
line to the left of the text in which it appears. An example 
of a flagged passage (taken from page 2-2) is given below. 

Each command is a line of ASCII characters in upper/lower 
case. Spaces and nonprinting characters preceding the com- 
mand name are ignored. Comments may be typed on the same 
line as the command by preceding the comment with a semi- 
colon. The Monitor Command Interpreter will not interpret or 
execute a line of comments. 
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Foreword 



The Timesharing Monitors are described and the commands, program loading procedures, and user pro- 
gramming available under executive control are discussed in this manual. The Timesharing Monitors 
include the Multiprogramming Monitor (formerly known as 10/40) and the Swapping Monitor (formerly 
known as 10/50). 

SYNOPSIS OF THE TIMESHARING MONITORS MANUAL 

Chapter 1, an introduction, contains concepts important to the understanding of the system. Commands 
to the monitor that may be initiated by a user at a terminal are described in Chapter 2. Several 
Monitor Support CUSPs (Commonly Used Systems Programs) are also discussed in this chapter. Loading 
of user programs is explained in Chapter 3. The [ob data area and the loader are described briefly. 
The services the monitor performs for the user and how the user's program obtains such services are 
discussed in Chapter 4. Non -directory I/O devices (e.g., concepts, data modes, special programmed 
operator services, file status) are discussed in Chapter 5. The two directory devices, DECtape and 
DISK, are explained in Chapter 6 in the same manner as the devices in Chapter 5 are explained. 
Algorithms of the monitor, described in Chapter 7, give the user an insight into system operation. 
Appendices A to J contain supplementary reference material. 

USE OF THE TIMESHARING MONITORS MANUAL 

The Timesharing Monitors Manual is intended primarily as a reference manual for experienced program- 
mers. The system manager and his programming and operations staffs may find additional information 
for operating and maintaining the PDP-10 timesharing system in the following publications: 

PDP-10 System Manager's Guide (DEC-IO-NWZA-D(L)) 
Five Series Monitor Installation Guide (DEC-10-MRZA-D) 

The user interested in timesharing programming from a remote Teletype® should read the PDP-10 Time- 
sharing Handbook, Books 2 and 7, for a detailed explanation of the monitor commands available. 



® 



Teletype is a registered trademark of Teletype Corporation. 
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CONVENTIONS USED IN THE TIMESHARING MONITORS MANUAL 

The following conventions have been used throughout this manual: 

dev: Any logical or physical device name. The colon must be in- 

cluded when a device is used as part of a file specification. 

list A single file specification or a string of file specifications. 

A file specification consists of a filename (with or without a 
filename extension), a device name if the file is not on disk, 
and a project-programmer number, if the file is not in the 
user's disk area. 

arg A pair of file specifications or a string of pairs of file speci- 

fications. 

job A job number assigned by the monitor. 

file, ext Any legal filename and filename extension. 

core Decimal number of IK blocks of core. 

adr An octal address. 

C(adr) The contents of an octal address. 

[proj,prog] Project-programmer numbers; the square brackets must be in- 

cluded in the command string. 

fs Any legal file structure name or abbreviation. 

($J The symbol used to indicate an altmode. 

tx A control character obtained by depressing the CTRL key and 

then the character key x. 

*■ A back arrow used in command strings to separate the input 

and output file specifications. 

* The CUSP response to a command string. 

The monitor response to a command string. 

} The symbol used to indicate that the user should depress the 

RETURN key. This key must be used to terminate every com- 
mand to the Monitor Command Interpreter. 

Underscoring used to indicate computer typeout. 

n A decimal number. 
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Chapter 1 
Introduction 



1.1 GENERAL 

The PDP-10 Timesharing System allows many independent user programs to share the facilities of a single 
PDP-10 computer. Many users can access the computer at the same time from consoles at the computer 
site, at nearby offices or laboratories, or at remote points connected by telephone lines. Operating 
concurrently under monitor control, users may access available I/O devices and system software to 
compile, assemble, and execute their programs, or may have this sequence performed automatically 
for many programs by using the batch control processor (Batch). Real-time programs can operate either 
as independent user programs or as fully integrated monitor subroutines. 

System facilities start with a minimum configuration of 32K of core and can accommodate DECtapes, 
magnetic tapes, disks, drums, disk packs, communication line controllers, card readers and punches, 
paper-tape readers and punches, line printers, displays, incremental plotters, and user consoles. 
Other special devices, including real-time digitizers and analog converters, easily interface with 
the system. Various peripheral devices and methods of programming are described in Chapters 5 and 6. 

1.2 MONITOR FUNCTIONS 

The timesharing operating system interfaces between the user and the computer so that all users are pro- 
tected from one another and appear to have most system resources to themselves. The operating system 
schedules multiple-user timesharing of the system, relocates and protects user programs in core memory, 
directs data flow between I/O devices and user programs, and overlaps I/O operations concurrently 
with computation for high system efficiency. 

The timesharing system is a multiprogramming system; that is, it allows several user programs to reside 
in core simultaneously and to operate sequentially. The timesharing operating system (TOPS) schedules 
each user program to run for a certain length of time ( quantum time) , using a scheduling algorithm that 
makes efficient use of system capabilities (refer to Paragraph 7.1). The switching between programs 
is initiated by a clock, which interrupts the central processor tosignal that the quantum time for the 
program has elapsed. The interrupt function is provided by the priority interrupt system (refer to the 
PDP-10 Reference Manual). 
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To increase the number of users serviced, a secondary memory is employed. This memory, usually 
magnetic disk or drum, is slower than main memory but provides greatly increased capability. User 
programs can be located in secondary memory and moved into main memory or core for execution. 
Programs moved into main memory exchange places with programs that have just been serviced by the 
central processor. This process is called swapping (refer to Paragraph 7.2). 

The asynchronous swapping algorithm is called in at every clock tick and has the task of bringing a 
user program from secondary memory into core, or vice versa. The central processor may be operating 
on one user program in one part of memory while another user program is being swapped to or from core. 
This independent overlapped operation greatly improves efficiency and increases the number of users 
that can be accommodated simultaneously. 

The timesharing operating system is involved in keeping the actions of a user within his assigned memory 
space. A hardware device, a memory protection register (refer to Chapter 3) set by the monitor, limits 
the core area that a particular user can access. Any attempt to read or change information outside this 
area automatically stops the program and notifies the operating system. 

1 .2. 1 Reentrant User Programming 

Users of large timesharing systems have varying requirements; therefore, a good system provides a 
variety of software. Thus, many users may have compilers and other common system programs in core 
at the same time. To prevent excessive core usage, which results when a program is duplicated for 
several users, a reentrant user programming capability is employed. This means that a sequence of in- 
structions may be entered by more than one user program at a time. 

A reentrant program is written in two parts or segments. One segment contains pure code that is not 
modified during execution and can be used to simultaneously service any number of users (e.g., the 
FORTRAN compiler). The second segment belongs to each user and consists of code and data (impure 
code ) that is developed during the compiling process. All versions of the timesharing operating system 
normally include this reentrant capability, but it may be deleted on systems lacking the dual relocation 
KT10A hardware option. 

In a non-reentrant system, the one-relocation register hardware requires that a user area be a single 
continuous segment of logical and physical core. Each user has a separate copy of a program although 
a large part of it is the same as for other users. In a reentrant system, the two-relocation register 
hardware allows a user area to be divided into two logical segments, which may occupy non-contiguous 
areas in physical core. The operating system allows one of the segments of each user area to be the 
same as one or more other users; therefore, only one physical copy of a shared segment need exist no 
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matter how many users are using it. The operating system normally invokes hardware write-protection 
for shared segments to guarantee that they are not accidentally modified. User programs may also be 
written to make use of this protection (refer to Appendix C). 

In the PDP-10 system, the reentrant capability causes the following system resources to be used more 
efficiently: 

a. Core memory. Only one copy of a shared segment exists for the entire system. 
More programs can fit into a given amount of core. (Figure 1-1 illustrates this 
efficient use of core memory.) 

b. Swapping storage. Many users share the single copy of the shared segment kept 
in swapping storage. 

c. Swapping I/O channel. A shared segment is read into core only once and is not 
written back onto swapping storage unless modified. 

d. File storage I/O channel . A shared segment exists on the faster swapping storage 
after it has been read into core the first time from the storage device, instead of 
being retrieved from file storage on each usage as necessary in a non-reentrant 
system. 
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Figure 1-1 Core Management 



1.3 USER FACILITIES 



The basic function of the timesharing system is to allow a number of users simultaneous access to the 
central computer. To be fully useful, however, the system should also allow the users access to other 
system resources, such as storage devices for the user's programs and data; therefore, the operating 
system includes I/O control of all devices attached to the system, run-time selection of I/O devices, 
job-to- job transition, and job save and restore features. 
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Users gain access to the PDP-10 timesharing system from a terminal located either at the computer 
facility or at a remote site connected by telephone. Three levels of communication available at the 
console are: 

a. monitor command level 

b. CUSP command level 

c. CUSP I/O level. 

At monitor command level, the console communicates with the Monitor Command Interpreter. The 
Monitor Command Interpreter 

a . provides the system with access protection 

b. allocates and protects memory and peripherals requested by the user 

c. provides communication with the operator for the mounting of special tapes 
and disk packs 

d . provides run control for the user over programs stored in the system 

e. allows the user to initiate background jobs 

f. provides the user with job monitoring and debugging facilities 

g. returns facilities to the system when the job is finished using them. 

Various monitor commands providing each of these capabilities are described in Chapter 2. 

Using monitor commands, the user at his console can call in programs from the file system. The file 
system contains programs for creating and editing program source files (TECO, LINED), for assembling 
or compiling program source files (MACRO, AID, FORTRAN, BASIC, COBOL), and for loading re- 
locatable binary files (LOADER). The use of these and many other CUSPs are described in the PDP-10 
Reference Handbook and the PDP-10 Timesharing Handbook. 

The user's console provides both a control and data path to any CUSP or other user program that the 
user initiates via monitor commands. When a particular CUSP is called in, the user's console is at 
CUSP command level and the user can issue a command to the CUSP. In processing that command, the 
CUSP may access the user's console directly as an input or output device. This is illustrated by the 
following example. 

iR PIP Monitor command level . User calls CUSP 

named Peripheral Interchange Program (PIP). 

*DSK:TEXT-TTY: CUSP command level . User instructs PIP to 

create a file on the disk named TEST using 
Teletype console as input medium. 

THIS IS FILE TEXT tz CUSP I/O level . User types input to PIP. 

tZ causes Teletype end of file. Return to 
CUSP command level. 

(continued on next page) 
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*. T C tC Fs a special character that causes return to 

monitor command level. 

i The period (.) signifies return to monitor com- 

mand level. 



The console is switched back to the Monitor Command Interpreter by either the program or the user. 
The user can exercise another dimension of control over his program by loading it with the powerful 
Dynamic Debugging Technique (DDT) available in the system file. Entry to DDT is through the Monitor 
Command Interpreter or by breakpoints in the program. While DDT is in control of the program, the 
user can examine intermediate results on his console and then modify his program accordingly. 

The user's program communicates with the monitor by the PDP-10 operation codes 040 through 077. 
These op-codes, called UUOs, are described in detail in Chapter 4. With these operation codes, the 
monitor provides the program with complete device-independent I/O services. The programmer is re- 
lieved of I/O programming and is freed from the dependence on the availability of particular devices 
at run time. In addition, the user's program may exercise control over central processor trapping, mod- 
ify its memory allocation, and monitor its own running time. Provisions exist for inter-job communica- 
tion and control, reentrant user programs, and, in selected cases, direct user I/O control. 

1.4 SEGMENTS 

A segment is a continuous region of the user's core area that the monitor maintains as a continuous unit 
in physical core/possibly fragmented unit on the swapping device. A program or user job is composed 
of one or two segments. A segment may contain instructions/data. The monitor determines the alloca- 
tion and movement of segments in core and on the swapping device. 

A sharable segment is the same segment for many users. The monitor keeps only one copy in core/on 
the swapping device, no matter how many users are using it. A non-sharable segment is different for 
each user in core/on the swapping device. 

The two PDP-10 relocation and protection registers, which divide a user's core area into two parts, 
permit a user program to be composed of one or two segments at any time. The required low segment 
starts at user location 0. The optional high segment starts at user location 400000 or at the end of the 
low segment, whichever address is greater. The low segment contains the user's accumulators, job data 
area, instructions/data, I/O buffers, and DDT symbols. A user's core image is composed of a low seg- 
ment, which may have from IK to 256K words, in multiples of IK (1K=1024. _ words), and a high seg- 
ment, which may have from OK to 128K words, also in multiples of IK. A high segment may be 
sharable or nonsharable, whereas a low segment is always nonsharable. The high segment is usually 
write-protected, although the program can turn off write-protection and modify itself (refer to 
Paragraph 4.5.4). 
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A reentrant program is always composed of two segments: a low segment, which usually contains data, 
and a high (sharable) segment, which usually contains instructions and constants. The low segment is 
sometimes referred to as the impure segment. The sharable high segment, if write-protected, is re- 
ferred to as the pure segment. 

A one-segment non-reentrant program is composed of a single low-segment containing instructions and 
data. User programs written for machines with only a single relocation and protection register are 
always one-segment non-reentrant programs. 

A two-segment non-reentrant program is composed of a low segment and a nonsharable high segment. 
This program is useful when there is a requirement for two fixed-origin data areas to increase and de- 
crease independently during execution. 

1 .5 FILE STRUCTURES 

A file structure is the logical arrangement of 128-word blocks on one or more units of the same type to 
form a two-level hierarchy of named files. File structures allow a user to specify which unit he wishes 
to use for his files. System reliability is increased because a file structure may be removed from the 
system without affecting other units. 

A complete disk system is composed of one or more units of the same/different types of disks and, 
therefore, consists of one or more file structures. All information in the system (programs and data) is 
stored as named files in a uniform and consistent fashion. A file structure can exist on exactly one 
unit but is usually distributed over a number of physical units of the same type; however, two file 
structures cannot exist on the same unit. Each file structure is logically complete and is the smallest 
removable unit of file memory. All pointers to blocks within a file structure are by way of logical 
block numbers rather than physical disk addresses. There are no pointers to blocks in other file struc- 
tures. This property allows a file structure to be removed from a disk system without disturbing any 
of the units in other file structures. 

1.5.1 File Directories 

Each file structure has two levels of directories: a Master File Directory (MFD) and User File Directo- 
ries (UFD). The entries in the MFD are the names of the User File Directories. The entries within the 
UFDs are the names of files existing in a given project-programmer number area within the file struc- 
ture (refer to Paragraph 6.2.2.3). Figure 1-2 shows the relationship of the directories. 
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Figure 1-2 File Structure Directories 



Each project -programmer number in each file structure is associated with two quotas that limit the 
number of blocks that can be stored in the UFD in the particular file structure. The two quotas are: 
logged-in quota and logged-out quota. The logged-in quota is not a guaranteed amount of space, and 
the user competes with other users for space. The logged -out quota is the amount of space that the user 
must be within in order to log off the system. Quotas are used by system administrators to ration re- 
sources in a predetermined manner. 



1.5.3 Files 

A file is a collection of 36-bit words comprising computer instructions/data. A file can be of arbitrary 
length, limited only by the available space on the device and the user's maximum space allotment on 
that device. A disk file is limited by the smallest available space on a file structure and by the user's 
quota on that file structure. 

A named file is uniquely identified in the system by its filename (up to six characters in length) and 
extension (up to three characters in length) and by its directory name (owner's project-programmer 
number) and file structure name for disk or physical device name for DECtape, in which the filename 
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and extension appear. The filename, being arbitrary, is specified by the owner, whereas the exten- 
sion, usually one of a small number of standard names that identify the type of information in the file, 
is usually specified by the program (refer to Appendix G). A named file may be written by a user 
program in buffered or unbuffered mode, or in both. It may be read/modified sequentially or randomly 
with buffered or unbuffered mode I/O independently of how it was written. Named files are uniformly 
stored. Each named file has a certain access protection associated with it. These protections desig- 
nate which users can read or write the file or change its access protections. For a given file, users 
are divided into three groups: the owner of the file, the users in his project, and the rest of the users 
(refer to Paragraph 6.2.3). 

A file is created if no file by the same name existed in the file structure when the file was opened 
for writing. A file is superseded if another file by the same name exists. A file is updated when one 
or more blocks of the file are rewritten in place. Other users may read a disk file while a certain user 
is superseding if. The older version of the file is deleted only when all the readers have finished with 
it. Only one user may open a file for updating at a time; all other users attempting to open that file 
receive an error message. 



1 .5.3.1 Comparison of Files and Segments - Files and segments have certain similarities and differ- 
ences. Both are named, one-dimensional arrays of 36-bit words. A named file can be as long as the 
size of DECtape or the sum of the available space on a file structure. A segment can be only as big 
as physical core. Both may be shared for reading, but only one user may supersede or update a file at 
a time, whereas many users may share a segment for writing. When many users share the same file, 
each user is given his own copy of the portion of the file that he is reading. It is read into his low seg- 
ment by the INPUT UUO. When many users share the same segment, each user does not have his own 
copy of the segment. A file exists on the file structure and portions of it may exist in different parts 
of the low segment of one or more users. A segment never exists on the storage device; a segment exists 
as a continuous unit only in core or on the swapping device. 
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Chapter 2 
Monitor Commands 



2.1 CONSOLE AND JOB CONTROL 

The PDP-10 timesharing system is a multiprogramming system. This means that control is transferred 
rapidly among a number of programs or processes in such a way that all the processes appear to be run- 
ning simultaneously. Each process is called a job. The term job refers to the entire sequence of opera- 
tions the user initiates from his console. In configuring and loading a timesharing monitor, the system 
administrator sets the maximum number of jobs that his system can handle simultaneously. This number 
may be up to 127 jobs if the system has enough core, disk storage, processor capacity, and timesharing 
consoles to handle this load. 

Jobs are initiated by users typing on a timesharing console. A console is typically any of several 
models of Teletype machines but may also be a cathode ray tube (CRT) with a keyboard or any of the 
other interactive terminals available. The console may be directly connected to the computer, or 
may be remotely connected via a private wire or the public telephone system. 

There is not necessarily a one-to-one relationship between jobs and consoles. A console must initiate 
a job, but the DETACH and ATTACH commands (refer to Paragraph 2.8) permit a job to float in a state 
where it is not associated with a particular console; therefore, a user may control several jobs from the 
same console. Each job is either in the ATTACHed or DETACHed mode depending on whether a con- 
sole is currently associated with that job. At any time, each console is attached to at most one job. 
The console is often referred to as being in a detached mode, but this results from a semantic confusion. 
It is really meant that the job initiated from that console is in a detached mode. By typing an appro- 
priate command, the job may be attached by the same console or by any other console in the system. 

2.1.1 Monitor and User Mode 

From the user's point of view, his console is either in monitor or user mode. In monitor mode, each 
line the user types in is sent to the Monitor Command Interpreter. The execution of certain commands 
(as noted in the examples below) places the console in user mode. When the program is in user mode, 
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the console becomes simply an I/O device for that user. In addition, user programs use the console 
for two purposes. The user program will accept command strings from the console or will use the con- 
sole as a direct I/O device. 



Example: 



monitor mode 
user mode 

user mode 

monitor mode 
user mode 

user mode 



iR PIP J 



*DSK:>1LE1 -TTY: J 



THIS IS FILE 1 'Z 



* T C 

^R MACROS 
*»TTY:«-DSK:PR0G1^ 



monitor command 

user program command 
string 

user program using console 
as an input device 

monitor command 

user program command 
string 

user program using console 
as an output device 



assembly listing 



The special character tC (produced by typing C with the CONTROL key depressed) is used to stop a 
user program and return the console to monitor mode. If the user program is in a Teletype input wait 
state, one tC must be issued from the user's console; otherwise, two tC's must be issued. Because of 
this procedure, the user knows if his program is waiting for input if there is no response from the moni- 
tor after one fC . Certain commands cause the user program to start or continue running (as noted in 
the tables below) but leave the console in monitor mode. 

When the system is started, each console is in monitor mode ready for users to begin typing in com- 
mands. However, if the system becomes fully loaded (i .e. , the maximum number of jobs that the sys- 
tem has been set to handle has been initiated), then any unused consoles enter a special state where 
any command typed in will receive either the message JOB CAPACITY EXCEEDED or X. 

2.2 COMMAND INTERPRETER AND COMMAND FORMAT 

Each command is a line of ASCII characters in upper/lower case. Spaces and nonprinting characters 
preceding the command name are ignored. Comments may be typed on the same line as the command 
by preceding the comment with a semicolon. The Monitor Command Interpreter will not interpret or 
execute a line of comments. Every command to the Monitor Command Interpreter must be terminated 
by pressing the RETURN key on the console. If the command is not understood, the command up to the 
error is typed out by the monitor preceded and fol lowed by a ? , and the mode is unchanged . 
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ANSWER TO SOFTWARE TROUBLE REPORT #10-1798 



Diagnosis : An assigned teletype should not be allowed to type 
commands at all. There is a difference between ASSIGNED and 



CONTROLLING teletypes. 



Solution: The fact that under SCNSRF in 4.72, an ASSIGNED tele- 
type does partially succeed in starting the command processor 
is a bug that has been fixed in the completely re-written SCNSER 
for the 5.02 release. After SCNSER reached the filed, SCNSRF 
will be obsolete, therefore we are no longer fixing bugs in it. 



DOC. CORR: 

Document Title: Timesharing Monitor 

DEC Number - DEC-T9-MTZB-D 

Chapter 2 

Page 2-2 



i At end of Section 2.1: Add the following: 

lit is also possible for a user to ASSIGN additional consoles to his 



ob, if they are not already in use. At any one time, however, onlyl 
TTY is actually ATTACHED to the job (i.e., controlling it). This 
ing TTY is automatically ASSIGNED to the job at the time the 
ob is initiated. The controlling TTY cannot be DEASSIGNED from the 
ob. 



me 



sontrollj 



snitor commands may be typed from controlling TTY's, but not from 
3SIGNED TTY'S. 



Lso: At end of DEASSIGN description, Table 2-2, add: 

it DEV is a controlling TTY, the logical device name is discarded, 
bit the TTY is not actually DEASSIGNED from the job. 



2.2.1 Command Names 

Command names are strings from one to six letters. Characters after the sixth are ignored. Only enough 
characters to uniquely identify the command need be typed. In the commands which follow, the com- 
monly used abbreviation of the command name is shown in parentheses. Installations choosing to imple- 
ment additional commands should take care to preserve the uniqueness of the first three letters of 
existing commands. 

2.2.2 Arguments 

Arguments follow the command name, separated from it by a space or any printing character that is not 
a letter or a numeral. Argument formats are described under the associated commands. 

If the Monitor Command Interpreter recognizes the command name, but a necessary argument is missing, 
the monitor responds with 

TOO FEW ARGUMENTS 
Extra arguments are ignored. 

2.2.3 Log-In Check (Disk Monitor Systems) 

I If a user who has not logged in (refer to Paragraph 2.3) types a command requiring him to be logged in, 
the disk monitor systems will respond with 

I 7LOGIN PLEASE 

and the user's command will not be executed. Log-in is not required by a nondisk monitor system. 

2.2.4 Job Number Check (Nondisk Monitor Systems) 

If the nondisk monitor system recognizes a command name, which requires a job number, and no job 
number has been assigned, the monitor assigns a job number, n, and responds with 

I JOBn 

and a line identifying the monitor version. The monitor then proceeds to execute the command. 
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2.2.5 Core Storage Check 

If the Monitor Interpreter recognizes a command name, which requires core storage to be allocated to 
the job, and the job has no core, the monitor responds with 

I ?NO CORE ASSIGNED 

The user's command is not executed. 

2.2.6 Delayed Command Execution 

If the Monitor Command Interpreter recognizes a command that requires all devices to be inactive, and 
the Job has devices actively transmitting data to or from its core area, the execution of the command 
is delayed until the devices are inactive. A command is also delayed if a job is swapped out to the 
disk and the command requires core residence. It will be executed when the job is swapped into core. 

2.2.7 Completion-of-Command Signal 

Most commands are processed without delay. The completion of each command is signaled by the out- 
put of a carriage return, line feed. If the console is left in monitor mode, a period follows the car- 
riage return, line feed. If the console is left in user mode, any response other than the carriage return, 
line feed comes from the user's program. For example, all standard DEC CUSPs (except DDT) immedi- 
ately send an asterisk (*) to the user's console to indicate their readiness to accept user-mode command 
strings. (DDT sends another carriage return, line feed.) 

| 2.3 JOB INITIALIZATION COMMANDS 

Access to the system is limited to authorized personnel. The system administrator provides each 
authorized user with a project number, a programmer number, and a password. The project numbers 
range from 1 to 377777 octal and the programmer numbers range from 1 to Z77177 octal. 

The project-programmer numbers identify the user and his file storage area on a file structure. The 
password is from one to six SIXBIT characters. To log-in successfully, the project-programmer numbers 
and the password typed in by the user must match the project-programmer numbers and password stored 
in the system accounting file (SYS:ACCT.SYS). 
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DOCUMENTATION CORRECTION 

MANUAL: Timesharing Monitors Programmer's Reference Manual 
DEC CODE: DEC-T9-MTZD-D 

LOCATION OF ERROR: Chapter 2, Section 2.2.7, Page 2-4 
CORRECTION OF ERROR: 




LOGIN (LOG) 



Function 



The LOGIN command is used to gain access to the system. This command loads a 
Monitor Support CUSP which accepts the user's LOGIN data. The user types in his 
project and programmer numbers followed by his password. 



Command Format 



LOGIN ppn 



ppn = the user's project-programmer number. This argument may be typed 
on the same line as the LOGIN command, or on the following line after 
LOGIN types out the number sign. 



Characteristics 



The LOGIN command: 

leaves the console in monitor mode or 

starts a program running if specified in ACCT.SYS. entry for ppn. 

runs the LOGIN CUSP, 

is used with disk monitors only. 

Associated Messages 

7INVALID ENTRY - TRY AGAIN 

An illegal project-programmer number was entered, or the password did 
not match. 

?l+l/nk CORE 
VIR. CORE LEFT =0 

The swapping space or core allocated to timesharing is all in use (i.e., there 
is no available virtual core). 

?JOB CAPACITY EXCEEDED 

This message is received by the first user who attempts to LOGIN after the 
maximum number of jobs that the system has been set to handle have been 
initiated. 

(continued on next page) 
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X 

If the system is fully loaded, any user (after the first) who attempts to 
LOGIN receives this character in response to any character typed. 

? SYSTEM NOT AVAILABLE 

The operator has used the SET SCHEDULE command to prevent LOGINS from 
all consoles. The message of the day is still typed. 

?NO REMOTE USERS. TRY AGAIN LATER 

The operator has used the SET SCHEDULE command to prevent LOGINs 
from remote consoles. The message of the day is still printed. 

?PRO JECT 1 MAY NOT BE REMOTE OR PTY 

Project 1 is never allowed to LOGIN at a remote teletype or over a 
pseudo-teletype, if using old scanner service. 

?SOME OTHER TIME 

User is not scheduled to LOGIN at this time. He should try again when 
he is allowed to log in. 

WAIT PLS 

FACT. SYS was busy for ten seconds. LOGIN retries for ten more seconds 
before trying FACT.X01 . This message can appear if many people are 
logging in simultaneously. 

7UFD OUTPUT FAILURE n 

The output failed when trying to create UFD (level C); n is the software 
channel status. 

?UFD ENTER FAILURE n 

Failure in trying to create UFD; n is the ENTER error code. 

?NO ENTRY IN AUXACC.SYS 

NO SEARCH LIST OR UFDS CREATED 

If user has no entry in AUXACC.SYS, LOGIN does not create UFDs or 
a search list. User is logged in and has UFDs if they existed previously. 
He may write on file structures which have UFDs or read file structures. 
He may also create a file structure search list with SETSRC (level D). 



(continued on next page) 
Revision 1 Monitors 2-6 January 1971 



ACCOUNTING SYSTEM FAILURE . . . 
CALL THE OPERATOR 

LOGIN could not append an entry to the accounting file. 

UFD LOOKUP FAILURE n 

A failure occurred in setting up UFDs (level D); n is the LOOKUP 
error code. 

UFD RENAME FAILURE n 

A failure occurred in setting up UFDs (level D); n is the RENAME 
error code . 

?UFD INTERLOCK BUSY 

Could not get UFD interlock when trying to set up UFD. UFD is 
not currently set up (level D). 

?CANT OPEN <file structure name > 

The file structure is mounted but cannot be opened. No UFD is created, 
though one may already exist. 

?CANT ADD TO YOUR RLE STRUCTURE SEARCH LIST n 

n is the error code from STRUUO when trying to add a file structure 
to search list. 

?MAY NOT LOGIN IN AS MFD PPN 

If MFD PPN is not the same as SYS PPN, no one may log in as the 
MFD PPN, even though there may be an entry in ACCT.SYS. 

?PPN HAS EXPIRED 

The current date is greater than the expiration date of the PPN. 
User may not log in until expiration date is changed. 

?ONLY BATCH USERS MAY LOGIN. TRY AGAIN LATER. 

The operator has used the SET SCHEDULE command to prevent 
LOGINs, except for BATCH jobs. The message of the day is still 
printed . 



(continued on next page) 
Revision 1 Monitors 2-6a January 1971 



?MAY NOT LOGIN 



{LOCAL 
REMOTE 
DATA SET 
BATCH JOB SUBJOB 



ACCT.SYS entry does not permit the project-programmer number to 
login at the teletype that is being used. 

?CANT ACCESS SYSTEM FILES 

ACCT.SYS could not be read. No one may LOGIN until ACCT.SYS 
is ready. Consult the operator. 

?WRONG FORMAT VERSION NUMBER IN SYSTEM FILES 

Wrong version of ACCT. SYS or AUXACC . SYS is on SYS. Consult 
the operator. 

<file structure name> FILE ERRORS EXIST 



One of the files in a file structure has an error status, as flagged 
in the UFD of that file structure. 



Example 



The following is the procedure used to gain access to the system. 



JOB 7 PDP- 



10 5S.01 TTY23 



LOGIN types the job number assigned to user 
(job number 7), followed by monitor name, 
version number, and console line number. 

LOGIN types out number sign to indicate user 
should type his project-programmer number. 
This happens only if the user did not type his 
project-programmer number on the same line 
as the LOGIN command. 



34*570 J 



PASSWORD: 



U35 8-AUG-70 

TYPE SYStSCHED FOR NEXT 

WEEKS SCHEDULE 



User types in his project-programmer number. 
The user may separate the project-programmer 
numbers with a slash causing LOGIN not to 
type the message of the day. Normally, this 
should not be done since the message frequently 
contains important operational information. 

System requests user to type his password. User 
types password followed by carriage return. To 
maintain password security, the monitor does 
dot echo the password. On half-duplex circuits 
(refer to Paragraph 5.9), a mask is typed to 
make the password unreadable. 

If user entries are correct, responds with time, 
date, a message of the day (if any), and a period, 
indicating readiness to accept a command. 
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INITIAL (INI) 



Function 



The INITIAL command performs standard system initialization for the terminal issuing 
the command. This command is issued automatically at system startup and 143 re- 
start at certain designated terminals, but may be re-issued at any time by the user. 
This command is used to initiate specific CUSPs, such as the line printer spooler 
CUSP, PRINTR, on a particular console. 

The INITIAL command runs SYS:INITIA.SAV which, depending upon the system 
configuration and the TTY number from which it is typed, may cause any of a 
number of events to occur. 



Command Format 
INITIA 

Characteristics 



The INITIAL command: 

leaves the console in monitor mode, 
runs a CUSP. 



Examples 



^INITIAL ) 

5S0111A SYS #2 22;12:17 TTY24 

EXIT 



2.4 FACILITY ALLOCATION COMMANDS 

The monitor allocates peripheral devices, file structure storage, and core memory to users on request 
and protects these allocated facilities from interference by other users. The monitor maintains a pool 
of available facilities from which a user can draw. 
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A user should never abandon a timesharing console without returning his allocated facilities to the 
monitor pool. Until a user returns his allocated facilities to the pool no other users may utilize them 
except through operator intervention. 

All devices controllable by the system are listed in Tables 5-1 and 6-1 . Associated with each device 
is a physical device name, consisting of three letters and zero to three numerals to specify unit number. 
A logical device name may also be assigned to a physical device by the user. The logical name of one 
to six alphanumeric characters of the user's choice is used synonymously with a physical device name 
in all references to the device. In writing a program, the user may use arbitrarily selected device 
names which he assigns to the most convenient physical devices at runtime. All references to devices 
in the monitor pool are made either by physical names or by assigned logical names. However, the 
preferred method for user programs to obtain device names is through a command string. 

When a nonsharable device is assigned to a job, it is removed from the pool of available facilities of 
the monitor. Any attempt by another job to reference the device fails. The device is returned to the 
pool when the user reassigns it or kills his job. 



ASSIGN (AS) 



Function 



The ASSIGN command assigns an I/O device to the user's job for the duration of 
the job or until a DEASSIGN command is given. This command, applied to 
DECtapes, clears the copy of the directory currently in core, forcing any 
directory references to read a new copy from the tape. (Refer to Paragraph 
6. 1 .7 for further details.) 

Although DECtape is the only device that must be ASSIGNed before use, 

to ensure that the monitor has a copy of the proper DECtape directory in core, 

it is wise to ASSIGN all devices, such as magnetic tape, before use. 



Command Format 



ASSIGN phys-dev log-dev 

phys-dev = any device listed in Tables 5-1 and 6-1, or any file structure. 
This argument is required. 



(continued on next page) 
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log-dev = a logical name assigned by the user. This argument is optional. 
Except for disk devices, only one logical name can be assigned to a physical 
device. Subsequent ASSIGN commands to all devices except disk devices 
replace the old logical name with the new one. Logical names are dis- 
associated from disk devices by the DEASSIGN command. 

NOTE 

If DTA, MTA, or LPT is used with no numeric argument, the 
monitor seraches for an available unit and then types DTAn, 
MTAn, or LPTn ASSIGNED. 



Characteristics 



The ASSIGN command: 

leaves the console in monitor mode. 



Restrictions 



A comma may not be used to separate the logical and physical device names. If a 
comma is used, the monitor terminates its scan at the comma; therefore, the logical 
name is not assigned. 

Associated Messages 

dev: ASSIGNED 

The device has been successfully assigned to the job. 

?NO SUCH DEVICE 

The device name does not exist, or all devices with this name are in use. 

?ALREADY ASSIGNED TO JOB n 

The device has already been assigned to another user's job. 

9LOGICAL NAME ALREADY IN USE, dev: ASSIGNED 

The user attempted to assign a previously-used logical name to this device. 

Examples of logical and physical device names 



^ASSIGN DTA ABC ) User requests a DECtape drive. 

DEVICE DTA6 ASSIGNED Monitor has given the user drive DTA6. 

The user mounts a DECtape on drive DTA6. 

_:_ASS1GN PTP ABC^) User requests the paper tape punch . 

LOGICAL NAME ALREADY IN USE* Paper tape punch is reserved, but ABC still 

PTP ASSIGNED refers to DTA6 only. 

_-_R PIP J User requests the system program PIP. 

(continued on next page) 
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*PTP:«-ABC:FILFX 



_*_T C 

^ASSIGN DTA DEF J 
NO Si)CH UNIT 

•ASSIGN DTA6 DEF J 



DEVICE DTA6 ASS1GNFD 

L R PIPj 

^PTP :-ARC :FILFY J 

?DFVICE ABC DOES NOT EXIST 
_*PTP:~DEF:FILEY J 

j_ASSIGN DTA 6 DEF^ 
DEVICE DTA6 ASSIGNED 



User issues a command string to PIP asking 
that the FILEX be transferred from device 
ABC (DTA6) to device PTP (assigned to the 
user). 

User returns to monitor mode. 

User requests another DECtape drive. 

All drives are in use. No DECtape drive is 
assigned, and no logical assignment is made. 

User requests drive DTA6 (which he already 
has). The logical device name ABC is no 
longer associated with DTA6. The copy of 
the directory currently in core is cleared. 

User mounts a new DECtape on the previous- 
ly assigned drive. The new DECtape direc- 
tory is read into core. 

User requests PIP. 

User requests that FILEY be transferred from 
device ABC to device PIP. 

The logical device name ABC is no longer 
assigned. 

User reissues the command string to PIP 
asking that FILEY be transferred from device 
DEF to device PIP. 

User returns to monitor mode. 

User requests drive DTA6 again. The old 
directory is cleared from core. 

User mounts a new DECtape. The new 
directory is read into core. The same logi- 
cal name is acceptable because the ASSIGN 
applies to the same unit (DTA6). 



Examples of ASSIGN command 



^ASSIGN DTA J 

^ASSIGN MTA2 J 
^ASSIGN DTA3 INP^ 

.ASSIGN MTA FAILSA^ 

.ASSIGN DSK PTR J 



The user assigns any available DECtape drive. 

The user assigns a specific magnetic drive (drive 2). 

The user assigns DECtape drive 3 and gives it logical 
name INP. 

The user assigns any available magnetic tape drive 
and gives it logical name FAILSA. 

The user assigns generic name DSK and gives it 
logical name PTR. 
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DEASSIGN (DEA) 



Function 



The DEASSIGN command returns one or more devices currently assigned to the user's 
job back to the monitor pool of available devices. The command, applied to DECtapes, 
clears the copy of the directory currently in core, forcing any directory references to 
read a new copy from the tape. (Refer to Paragraph 6.1.7 for further details.) 



Command format 



DEASSIGN dev 



dev = either the logical or physical device name. This argument is optional . 
If it is not specified, all devices assigned to the user's fob, except the control- 

(ling Teletype, are deassigned. The logical name of the controlling Teletype 
is cleared whether or not an argument is specified. 

Characteristics 

The DEASSIGN command: 

leaves the console in monitor mode, 
I requires LOGIN and a job number. 

Associated Messages 



?NO SUCH DEVICE 

The device name does not exist in this monitor configuration. 

?dev WASN'T ASSIGNED 

The device is not currently assigned to this job . 

Examples 

^DEASS I GN LPTj The line printer is returned to the monitor's 

pool of available resources. 

^DEASS IGN^ All devices assigned to the job are returned. 
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REASSIGN (REA) 



Function 



The REASSIGN command allows one job to pass a device to a second job without 
having the device go through the monitor device pool . This command clears the 
copy of the directory currently in core, but does not clear the logical name 
assignment . 



Command format 



REASSIGN dev job 



dev = the physical or logical name of the device to be reassigned. 
This argument is required. 

job = the number of the job to which the device is to be reassigned . 
This argument is required. 



Characteristics 

The REASSIGN command: 

leaves the console in monitor mode, 

requires core, 

does not allow an active device. 

Restrictions 
| Console (controlling) Teletype cannot be reassigned. 

Associated Messages 

?dev WASN'T ASSIGNED 

The device is not currently assigned to the user's job . 
?NOTA JOfi 

The job number specified has not been initialized. 

?NO SUCH DEVICE 

The device does not exist in this monitor configuration. 

(continued on next page) 
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?dev CAN'T BE REASSIGNED 

(1) The console (controlling) Teletype cannot be reassigned, or (2) the logical 
name is duplicated, or (3) the logical name is a physical device name in the 
system . 



Examples 



^REASS IGN LPT 1 1} Reassign the line printer to job 17. 

; reass ign cdp a) Reassign fhe card pmch te |ob 4> 



MOUNT (MOU) 



Function 



The MOUNT command allows the user to gain access to a file structure. This command 
notifies the operator to mount packs (if necessary), allows the user to specify specific 
drives, places the file structure name at the end of the jobs search list, and waifs for 
completion of operator action (if desired). 

The MOUNT command runs the UMOUNT CUSP in the user's core area. UMOUNT 
scans the command string and does as much as it can without operator intervention. 
UMOUNT can always complete the action requested by the MOUNT command if the 
file structure is already mounted and ready. If operator intervention is required, 
UMOUNT queues a request to the OMOUNT CUSP by writing a command file on 
3, 3 disk area. OMOUNT reads these command files and interacts with the operator. 
When the command file is deleted, the operator action has been completed. 

Command Format 

MOUNT dev: switches <drives > 

dev: = the file structure name as recorded in STRLST.SYS. This argument 
is required. 

switches = /HELP (type this list) 

/WENABL ( wr i r e enable, default condition, 

complement of /WLOCK) 
A/LOCK (write locked) 

/RONLY (read only, same as WLOCK) 

/MULTI (multi-access, default condition, 

complement of /SINGLE) 
/SINGLE (single access) 

/CHECK (check and list pending requests) 

/LIST (list physical drive names 

and file structure status) 
/SYSTEM (add file structure to SYS search list) 

The switches are optional and only enough characters to make the switch 
unique are required . 

(continued on next page) 
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<drives>= the physical drives on which the units are to be mounted. The 
drives must be in the logical unit order within the file structure. Drive 
names are separated by commas. Leading and embedded drives that are 
not specified must be represented by null names (,,DPA3). Unspecified 
trailing drives may be omitted. Drive names are as follows: 

Blank, null - unspecified. UMOUNT finds one of proper 
type. 

Two letters - controller class. This may not be useful since 
file structure units are bound to one controller class* 

Three letters - specific controller. UMOUNT finds a drive. 

Three letters and one or two digits - specific drive. 

The user, by specifying a drive list, may force the packs to be mounted on 
specific drives or controllers. If no drive (or incomplete) specification is 
given, an available drive of the proper type is found, even if a dormant 
file structure must be removed. 



Characteristics 



The MOUNT command: 

places the console in user mode, 

runs the UMOUNT CUSP, 

is used with disk monitors only. 



Associated Messages 



If a special condition is encountered, a descriptive comment is typed to the user, and 
the command is continued. If the condition cannot allow the command to be continued, 
an error message preceded by a question mark is typed, and the command is aborted, 
(See Appendix F for these messages.) 

WAITING... 

A request has been queued to the operator, and the command is waiting 
for completion of the request. If the user does not want to wait for the 
completion of the operator's action, he may type control -C without 
aborting the command. 

STRUCTURE ALREADY MOUNTED 

The specified file structure is already mounted. However, it may not be 
in a readied condition. 

OTHER USERS - CANNOT SINGLE ACCESS 

The /S switch has been typed, and there are currently other users of the 
file structure. The switch is ignored. 

UNIT id ALREADY MOUNTED ON DRIVE DPAn 

The file structure is already mounted on a different drive than specified 
by the user. 

(continued on next page) 
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mCO 30-604 

••*•**•••■ 

COMMOO 
SY^PTOMJ 

DIAGNOSIS} 
CUREl 



(RLK) DOCUMENTATION CHANGE 



PPI51 

94, \*1 

0M3LTH/UH0UNT CAN'T ALLOW "ONLY USER" OF 
F/S TOIS^ANGE STATUS (E,G, WRITVp&OTECTION) 
BECAUSE SWUUO WON'T ALLOW IT/CNLESS USER' IS 
ALSO S I NGL&r ACCESS," 

STRUUO CAN'T T€LL IF JOB^JS "ONLY USER" 
UNLESS IT IS SfVGLE-AMSS (JOB # IN STRJQB), 

CHANGE MEANING OFVfRJOB AS FOLLOWS! 

s XWD 2,H- IF Oj/ttQRE THAN % $08 HAVE F,S 

* XWD -1, N IFyrfDB N\IS ONLY/JOB WITH F,s; 

MOUNTED (SINGLE ACCES\OR NOT), 

« XWQ B,N IF/JOB N HAS\T MOUNTED SJNGLE- 

ACCESS, 

CHANGEXCTION OF STRUUO ASN[OLLQWS! 
WRITE^fROTECTION (UNPAWL JN^NIDES) AND 
SINM-ACCESS (UNPSAF IN UNJDES) ARE 
ALLOWED TO BE CHANGED IF F, S, MOUNTED BY 
<3/?R dKiv i J08 (SINGLE-ACCESS OR 'NOT), 

'NOTE I TME MONITOR (STRUUO) DECIDES JF THESE 
BITS CAN BE CHANGED BUT LEAVES THEDECISION 
AS TO WHO MAY CHANGE THEM TO THE NON-RESIDENT 
MODULE (CUSP) OMOUNT, ' " ~ 



MCO #0-636 



DOCUMENTATION CHANGE 



FILSER 
SYMPTOMI 

CUREl 



PP« 99, 103, t&8 

NO WAY TO ADD/REMOVE F.S.'S TO/FROM SYSTEM 
SEARCH LIST, 

REMOVE I IF F,S, JS IN SYS.S ,L," DELETE 
FROM SYS.S.L, ALSO ADO WARNING MESSAGE IN 
OMOUNT, 

ADD EXTRA ARGUMENT (SPECIAL ACTION 
BITS) AMD DEFINE BIT • X TO MEAN "ALSO 
AD^ TO SYS.S.Lt" ADO SWITCH "/SYSTEM" TO 
MO-NT COMMAND (OMOUNT ONLY) TO CAUSE F,S, 
TO BE ADDED TO SYS,S.L< 



«C0 #D-596 



/ 



(TH) DOCUMENTATION CHANGE LEVEL C ,8<iG TOO 



CQMMOD 
SYMPTOM! 

CUREl 



DISK PACK ERRO« RECOVERY, DQ£S NQT FOLLOW 
ME^OREX SPECIFICATIONS, / 

C>iANGE DSKTRY FROM 3 TO yf SO DATA ERRORS WjuL 
BENtRIED 10 TIMES I.NSfE/D OF 3 BEFORE &EI.NG. 
CALLESJ A HARD DATA ER^R, 



hCO #0-59t 



(T-^) 



DQCUM\NMTIQN CHANGE 



CQMMOD 

COMMOD 

SYMPTOMI 
CUREI 



WRTBi 



FIELD SER/ICE NEEDS MQRX HARDWARE INFORMATION 
ON DISK /RRORS, 

ADO co/l SITS 12 THROUGH 29\qR RC*10 *ND 
RP-IS/In LH OF 2ND WORD OF 8A\ BLOCK, THE 
LH l4 CURRENTLY UNUSED SINCE 0%Y NEED 1* 
BITS TO STORE LOGICAL BLOCK OF TOE BIGGEST 
UNIT DIGITAL MAKES SO FAR, DSKLSt WILL TYPE 
THIS STATUS OUT ON /B SWITCH, 



DPAn NOT READY 

The specified drive is off-line or write-locked when wrire-enable is requested. 
The operator is notified. 

NEW UFD CREATED ON STRUCTURE 
RESERVED (n) F.C.F.S (n) LOGGED-OUT (n) 

An initial UFD has been created for the user. The numbers n are the block quotas 
on this file structure as established by QUOTA. SYS. 

UFD QUOTAS CHANGED 

RESERVED (n) F.C.F.S (n) LOGGED-OUT (n) 

The block quotas established by QUOTA. SYS on this file structure have 
changed since the user last used this file structure. The user's UFD are 
changed to specify the indicated quotas. 

OPERATOR REQUESTED TO READY DRIVES 

A request is queued to the operator to mount and ready the packs on the proper 
drives. 

DPAn NOT AVAILABLE 

The drive specified by the user is not currently available. 

NOT ENOUGH DRIVES 

There are not enough drives of the right type to mount the file structure. 

MOUNT COMPLETE 

The file structure is mounted and ready for use. The MOUNT command 
has completed. 



Examples 



jj^OUNT MONITR:^ Asks the operator to mount the file 

sttructure named MONITR. 

jKOUNT PAYROL: <DPA,DPB>/S ) Requests that the first unit of file 

structure PAYROL be mounted in 
Controller A, the second unit on 
Controller B, and any remaining 
units on any drives. All units are 
single access, (i.e., available only 
to this job). 
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DISMOUNT (DIS) 



Function 



The DISMOUNT command allows a user to withdraw his access to a file structure. 
This command enforces logged-out quotas (if necessary), allows physical removal 
of disk packs (if there are no other users of the pack), and removes the file structure 
name from the job's search list. 

The UMOUNT CUSP runs privileged in the user's core area when the DISMOUNT 
command is typed. This CUSP scans the user's command string, checks its validity, 
and performs as much of the requested action as possible. The UMOUNT CUSP 
can complete all actions requested by the DISMOUNT command except for the 
action of physically removing a pack. When operator action is required, the 
UMOUNT CUSP writes a command file on 3,3 disk area for the OMOUNT CUSP. 
(By scanning the command files, the OMOUNT CUSP can request operator action.) 
When the command file is deleted, the UMOUNT CUSP knows that an operator 
action has been completed. 



Command Format 



DISMOUNT dev: switches 

dev: = the file structure name as recorded in STRLST.SYS. This argument 
is required. 

switches = /HELP (type this list) 

/CHECK (check and list pending requests) 

/REMOVE (notify operator to physically remove pack) 

The switches are optional, and only enough characters to make the switch 
unique are required. 

When /R is requested, the file structure is deleted from the system if no other 
users are using it, a request to remove the pack is queued to the operator, 
and the message WAITING. . . is typed to the user. If the user does not 
want to wait for confirmation of the operator action, he may type control-C. 



Characteristics 



The DISMOUNT command: 

places the console in user mode, 

runs the UMOUNT CUSP, 

is used with disk monitors only. 
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Associated Messages 



If the condition cannot allow the command to be continued, an error message preceded 
by a question mark is typed, and the command is aborted. (See Appendix F for these 
messages.) 

WAITING... 

A request for operator action has been queued and the command is waiting for 
completion of the action. 

OTHER USERS- CAN'T REMOVE 

A /R switch has been issued while there are other users of the file structure. 
The switch is ignored. 

OPERATOR REQUESTED TO REMOVE PACKS 

A request to physically remove the pack has been queued to the operator. 

DISMOUNT COMPLETE 

The DISMOUNT command has been completed. 



FINISH (FIN) 



Function 



The FINISH command terminates any input or output currently in progress on the device 
specified and automatically performs the RELEASE UUO and DEASSIGN command, thus 
making the device available to another user. 



Command Format 



FINISH dev 



dev = the logical or physical name of the device on which I/O is to be 
terminated. This argument is optional . 

If dev is omitted, I/O is terminated on all devices, except the controlling 
Teletype, assigned to the job. The logical name of the controlling Teletype 
is cleared. 

Characteristics 

The FINISH command: 

leaves the console in monitor mode, 
requires core. 
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Associated Messages 



?NO SUCH DEVICE 

Either the device does not exist or it was not assigned to this job. 



Examples 



FINISH cmj 
FINISH OTAT^) 
FINISH LPT^ 



CLOSE (CLO) 



Function 



The CLOSE command terminates any input or output currently in progress on the device 
specified, and automatically performs the CLOSE UUO. Files are CLOSEd, but not 
reset, and logical names and device assignments are preserved. 



Command Format 



CLOSE dev 



dev = the logical or physical name of the device on which I/O is to be 
terminated. This argument is optional . 

If dev is omitted, I/O is terminated on all devices, except for the 
controlling Teletype, assigned to the job, and all files are CLOSEd. 



Characteristics 



The CLOSE command: 



leaves the console in monitor mode, 
requires core. 

Associated Messages 

?NO SUCH DEVICE 

Either the device does not exist or it was not assigned to this job. 

(continued on next page) 
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Examples 



XLOSE PTRJ 
.CLOSE DEVAV 
7CLOSE^ 



SETCDR 



Function 



The SET CDR command sets the filename for the next card-reader spooling 
intercept. 



Command Format 



SET CDR filename 



filename =one-to three-character filename to be used on next card- 
reader INIT. 



Characteristics 



The SET CDR command: 

leaves the console in monitor mode, 
is used with disk monitors only, 
requires LOGIN. 



Associated Messages 
None 

Examples 



^SET CDR f\J 
.SET CDR MAS^ 
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SET SPOOL 



Function 



The SET SPOOL command adds devices to or deletes devices from the current 
spool list. 



Command Formats 



T) SET SPOOL devl , dev2, . . .devn 

adds the specified devices to the job's spool list. 

2) SET SPOOL ALL 

places all spooling devices into the spool list. 

3) SET SPOOL NONE 

clears the entire spool list. 

4) SET SPOOL NO devl , dev2, . . .devn 

removes the specified devices from the job's spool list. 



devl , dev2, . . .devn - names of one or more devices to be added to 
or deleted from the current spool list. 



Characteristics 



The SET SPOOL command: 

leaves the console in monitor mode, 
is used with disk monitors only, 
requires LOGIN. 



Restrictions 



To unspool devices, the job must have either the privilege bit set in 
JBTPRV, or the bit .UNSPL set in the STATES word. * 
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Associated Messages 

?NO PRIVS TO UNSPOOL 

The job does not have privileges to unspool devices. 

Examples 

^SET SPOOL CDP> 
^SET SPOOL NO LPTJ 
.SET SPOOL NONE^ 



SEND (SEN) 



Function 



The SEND command provides a mechanism for one-way interconsole communication. 
(This command replaces the TALK command.) A line of information is transmitted 
from one terminal to another, with the identification of the terminal sending the 
information. 

When the SEND command is sent from the operator's console (OPR) it allows a broadcast 
of a line of information to all terminals in the system. This allows important information 
to be dispersed, such as system shutdown or hardware problems. 

A busy test is made before the message is sent unless the sender of the message or the 
receiver of the message is OPR. The receiver of the message is considered busy if his 
terminal is not at monitor command level . If the receiver is busy, the sender receives 
the message BUSY and the information is not sent. If the receiving console is turned 
off, the information appears to have been sent, since the hardware cannot detect this 
condition on hard-wired terminals. 



Command Format 



SENDdev: text 

or 

SEND JOB n text 



dev - any physical Teletype name (CTY included) or OPR. If the Teletype sending 
the message is OPR, the argument may be ALL to provide the broadcast operation. 

n = the job number to which the message is to be sent. 

(continued on next page) 
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The message printed on the receiving terminal appears as follows: 

;;TTY n: - text 
where 

n is the TTY sending the message, and text is the message. 



Characteristics 



The SEND command: 

leaves the console in monitor mode. 

Associated Messages 

?BUSY 

The receiving terminal is not at monitor command level. 

?ILLEGAL JOB NUMBER 

The job number is too large. 

?NO SUCH TTY 

The console number specified is not part of the system configuration. 

?NOT A JOB 

The job number specified does not exist. 

Examples 

•SEND OPR: PLEASE WRITE-ENABLE DTA3 J 



PLEASE (PL) 



Function 



The PLEASE command allows the user non-conflicting two-way communication with 
the machine operator. 



2-19 



Command format 



PLEASE dev: text 



dev: - device (TTY) with which to communicate. If absent, TTYO: 
is assumed. 

text = the user's message. The argument is required. Characters are not 
transmitted until the RETURN, vertical tab, or form feed key is depressed, 
at which point the entire line is transmitted. 

When the user depresses the RETURN, vertical tab, or form feed key, a 
message informing the operator of the TTY number, proj-prog number of 
the user, and the time of day is printed on dev: An ALTMODE or conrrol-C 
on either the user's console or dev: causes communication to terminate and 
the user's TTY to be left in monitor mode. Note that when the line terminates 
with an ALTMODE, the line is typed but the operator response is not waited for. 



Characteristics 



The PLEASE command: 



places the console in user mode, 
runs a CUSP. 



Associated Messages 

OPERATOR BUSY, HANG ON PLEASE 



The user must wait for the operator to become available. The user does 
not need to issue another PLEASE command. 

OPERATOR HAS BEEN NOTIFIED 

The operator is available, and the user may continue with his message 
or wait for a response from the operator. 



Example 



•PLEASE TELL ME WHEN DTA3 WIL BE FREE J 

OPERATOR HAS BEEN NOTIFIED 

IN HALF AN HOUR ~ — 

THANKS 

tC 
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CORE (COR) 



Function 

The CORE command types out or modifies the amount of core assigned to the user's job. 

Command Format 



COREn 

n = a decimal number. This argument is optional . 

If n is omitted, monitor types out the amount of core used and does not 
change the core assignment. 

If n = 0, the low and high segments disappear from the virtual addressing 
space of the job . 

If n > 0, n represents the total number of IK blocks of core to be assigned 
to the job from this point on. 

If n is less than high plus minimum low segment size, n plus high segment 
size is assumed. 

Characteristics 



The CORE command: 



leaves the console in monitor mode 
does not allow an active device. 
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Associated Messages 



In Multiprogramming Systems: 

m/p 

Key: m = number of IK blocks in low segment. 

p = maximum K per job. Free plus dormant core. 



(continued on next page) 
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In Swapping Reentrant Systems: 

m+n/p CORE 
VIR. CORE LEFT=v 

Key: m = number of IK blocks in low segment, 
n = number of IK blocks in high segment, 
p = maximum K per job. 

Maximum physical user core unless limited by operator or there 
are jobs locked in core (refer to Chapter 8). 

v = number of K unassigned in core and on the swapping device. 

?TRY LARGER ARG 

n is too small for this program. This message is followed by the standard 
output. 



Example 



j£ORE 5 J 

^CORE J 

5+0/46K COKE 

VIR. CORE LEFT = 274 



R GRIPE 



Function 



This command runs the GRIPE CUSP which reads text from a user and records it in a disk 
file. The GRIPE CUSP enables users to record comments and complaints. 



Command Format 



R GRIPE 



When the CUSP responds with a YES?, type the text, using as many lines 
as necessary, terminated with an altmode. The text is written as a file and 
includes a header with the date, time, and project programmer number of 
the user writing the comment. Therefore, the user does not need to identify 
himself. 
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Characteristics 



The R GRIPE command: 

places the console in used mode, 

runs the GRIPE CUSP, 

requires a job number and LOGIN. 



Associated Messages 



None 



Example 



_^R GRIPE J 

YES? (TYPE ALT MODE WHEN THROUGH) THIS CONSOLE IS 



ALMOST OUT OF" PAPERS 

THANK YOU 

EXIT 



RESOURCES (RES) 



Function 



The RESOURCES command prints the names of all available devices (except TTY's 
and PTY's), all file structures, and all physical units not in file structures (unless 
they are down or nonexistent). 



Command Format 



RESOURCES 



Characteristics 



The RESOURCES command: 

leaves the console in monitor mode, 
does not require LOGIN. 
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Associated Messages 
None 

Example 



DSKA,nSKB,DPA2,CDR,PTR,LPT,DTA0,l ,3W»Mft0. 1,PTP 



2.5 SOURCE FILE PREPARATION COMMANDS 

The following commands call in the editing programs and cause these programs to open a specified text 
file for editing. Two of these commands call the TECO CUSP and two call the LINED CUSP (a disk- 
oriented version of EDITOR). For each editor, one command causes an existing file to be opened for 
changes and the other command causes a new file to be created. Each command requires a filename 
as its argument and may have an optional extension. 

Filenames are one to six letters or digits. All letters or digits after the sixth are ignored. A filename 
is terminated by any character other than a letter or digit. If a filename is terminated by a period, a 
filename extension is assumed to follow. A filename extension is from zero to three letters or digits. 
It is generally used to indicate file format. The filename extension is terminated by any character 
other than a letter or digit. (See Appendix G). 

Each time one of the commands listed below is executed, the command with its argument is remembered 
as a file on the disk; therefore, the filename edited last may be recalled for the next edit without 
specifying the arguments again. For example, if the command 

•CREATE PROGl .MAC 

is executed, then the user may later type the command 

• EDIT 

instead of 

.EDIT PROGl .MAC 

assuming no other source file preparation command was used in the interim. 
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ANNOUNCEMENT 



COMPILE Version 15A is available and will be 
distributed automatically as a SOUP update via 
paper tape. A list of corrected bugs is on 
the overleaf. 



BUGS FIXED 



STR 10-2339 



COMPIU DID NOT AUOW RENAME WITH PROTECTION, 
REN F0U<i35>sF00 " "" ^* y "« 

STR 10-2557 

MULTIPLE ASSIGNMENTS DID NOT GIVE AN ERROR, 

E.G. T1*T2»T3 '"* "" "" *' ' 

COMPIL IGNORED AN EXTENSION SPECIFIED FOR THE OUTPUT 

FILE AND USED REL INSTEAD, " ' "* ~- P *™*I 

E.G. COM Tl.RH*Tl' " 

STR 10-2604 

PlP CLASS COMMANDS COULD NOT HANDLE CPROJECT-PROG3 NUMBERS 
E.G. DEL FQ0C1.4] * ■•■ ~ iswnot«&. 



4 * "vpsf^^J^IS^K^URE: C0MPiL " (WirH T^"n^W3K PUKE. 

^% S iE\E\ 5 ELTo S AT A A"p% P |! 20M T ° REIAIN ^ NAME 8L -°^ 

6. /MAP NOW TAKES AN OPTIONAL FILE NAME, 
E.G. /MAP: 5502 

THIS IS USED IN THE MONITOR LOAD FILE. 
THE MAP IS NOW OUTPUT JUST BEFORE "THE LOADER TERMINALS, 

7 ' SPECIFICATIONS? N ° W TAK " 0PTI0NAL D I' V «W AND PRRJ-PROG. 



CREATE (CREA) 1 



Function 



The CREATE command runs LINED (Line Editor for disk) and opens a new file on disk 
for creation . 



Command Format 



CREATE file.ext 



file.ext= any legal filename and filename extension. The filename is 
required; the filename extension is optional. 



Characteristics 



The CREATE command: 



places the console in user mode, 
runs the LINED CUSP, 
is used with disk monitors only, 
requires a job number and LOGIN. 



Associated Messages 

Refer to Table 2-1 

Example 



•CREATE! TESTl .FA J 



This command runs the COMPIL CUSP, which interprets the commands before running LINED. 
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EDIT (ED) 



Function 



The EDIT command runs LINED (Line Editor for disk) and opens an already existing 
sequence -numbered file on disk for editing. 



Command Format 



EDIT file.ext 

file.ext= a filename and filename extenstion of an existing file. 



Characteristics 



The EDIT command: 



places the console in user mode, 
runs the LINED CUSP, 
is used with disk monitors only, 
requires a Job number and LOGIN. 



Associated Messages 

Refer to Table 2-1 

Example 



^FDIT TEST.F4 J 



This command runs the COMPIL CUSP, which interprets the commands before running LINED. 
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MAKE (MA) 1 



Function 



The MAKE command runs TECO (Text Editor and Corrector) and opens a new file on the 
disk for creation. 



Command Format 



MAKE file. ext 



file.ext = any legal filename and filename extension. The filename is 
required; the filename extension is optional. 



Characteristics 



The MAKE command: 



places the console in user mode, 
runs the TECO CUSP, 
is used with disk monitors only, 
requires a job number and LOGIN. 



Associated Messages 

Refer to Table 2-1 

Example 



.P'AKE TEST3.t*AC ) 



This command runs the COMPIL CUSP, which interprets the commands before running TECO. 
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TECO (TE) 1 



Function 



The TECO command runs TECO and opens an already existing nonsequence-numbered 
file on disk for editing. 



Command Format 



TECO file.ext 

file.ext = a filename and filename extension of an existing file. 



Characteristics 



The TECO command: 



places the console in user mode, 
runs the TECO CUSP, 
is used with disk monitors only, 
requires a job number and LOGIN. 



Associated Messages 



Refer to Table 2-1 

[CREATING NEW FILE] 

The specified file does not exist; therefore, a MAKE command is assumed 
bytheCOMPILCUSP. 



Example 



.TTCO TEST! .MAC J 



This command runs the COMPIL CUSP, which interprets the commands before running TECO. 
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Table 2-1 

Monitor Command Diagnostic Messages 

(For File Manipulation) 



Message 


Meaning 


COMMAND ERROR 


The COMPIL CUSP cannot decipher the command. 


DEVICE NOT AVAILABLE 


Specified device could not be initialized. 


EXECUTION DELETED 
(typed by LOADER) 


Errors detected during assembly, compilation, 
or loading prevent a program from being executed. 
Loading will be performed, but LOADER will 
EXIT to the monitor without starting execution . 


FILE IN USE OR PROTECTED 


A temporary command file cannot be entered 
in the user's UFD. 


?FILENAME ALREADY IN USE 


The specified file already exists. 


INPUT ERROR 


I/O error occurred while reading a temporary 
command file from the disk. 


?INPUT FILE NOT FOUND 


The specified file does not exist. 


LINKAGE ERROR 


I/O error occurred while reading a CUSP from 
device SYS:. 


NESTING TOO DEEP 


The @ construction exceeds a depth of nine 
(may be due to a loop of @ command files). 


NO SUCH FILE - file.ext 


Specified file cannot be found (may be a 
source file or a file required for operation of 
COMPIL CUSP). 


NOT ENOUGH CORE 


System cannot supply enough core for use as 
buffers or to read in a CUSP. 


OUTPUT ERROR 


I/O error occurred while writing a temporary 
command file on disk. 


PROCESSOR CONFLICT 


Use of + construction resulted in a mixture of 




source languages. 


TOO MANY NAMES or 
TOO MANY SWITCHES 


Command string complexity exceeds table space 
in COMPIL CUSP. 


UNRECOGNIZABLE SWITCH 


An ambiguous or undefined word followed a 
slash (/). 



2.6 FILE MANIPULATION COMMANDS 

Some of the following commands perform complex functions requiring a number of commands on a less 
sophisticated system. The commands below list the user's files and file directories, rename and delete 
files, provide remote control of DECtapes, allocate disk space, and manipulate job search lists. 
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TYPE (TY) 



Function 

The TYPE command directs PIP (Peripheral Interchange Program) to type the contents 
of the named source file(s) on the user's Teletype. 

To stop the typing, type tC twice. 
Command Format 



TYPE list 



list = a single file specification or a string of file specifications separated 
by commas. This argument is required. 

A file specification may consist of a filename (with or without an extension), 
a device name if the source file is not on disk, a project-programmer number, 
if the source file is not in the user's disk area, and a protection. 

Examples of file specifications: 
PROG, PROG 1. MAC, 
DTA3:PROG2,PROG4[10,16] 

In addition, the * construction may be used as follows: 

filename.* All files with this filename and any extension. 

*.ext All files with this extension and any filename. 

*.* All files 



Characteristics 



The TYPE command: 



leaves the console in monitor mode, 
runs the COMPIL CUSP, 
is used with disk monitors only, 
requires LOGIN. 



Associated Messages 

Refer to Table 2-1 

Examples 



L TYPF FILFA,DTA!/) : FI LFB • fiAC ) 
JjYPF * .TMP*DTA./i:C[ 1 5*1073 J 
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LIST (LI) 



Function 



The LIST command directs PIP to list contents of named source fi!e(s) on the line 
printer (LPT). 



Command Format 



LIST list 



list = a single file specification or a string of file specifications separated 
by commas. This argument is required. 



Characteristics 



The LIST command: 



leaves the console in monitor mode, 
runs the COMPIL CUSP, 
is used with disk monitors only, 
requires LOGIN. 



Associated Messages 

Refer to Table 2-1 

Examples 



_^LIST TFST.* J 
^LIST *.MAC ) 
• LIST DT44:A.>B.>C J 
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R PRINT 



Function 



The R PRINT command queues files upon the disk to be printed when the line printer is 
available. 



Command Format 



R PRINT 



The user types in the names of the files to be printed, separated by commas. 
Only disk devices may be specified. If no device is specified, DSK is 
assumed. A particular file structure may be specified when there is more 
than one file with the same name in different file structures. Filenames 
may be continued on the next line by typing a hyphen followed by a carriage 
return. To delete a file after it is printed, insert the /D switch after the 
filename. To preserve a file that PRINTR would normally delete, insert the 
/P switch after the filename. To make more than one copy of the file, type 
a number from 2 to 9 as a switch. 



Characteristics 



The R PRINT command: 

places the console in user mode, 

runs the PRINTR CUSP, 

requires a job number and LOGIN. 



Associated Messages 



?CAN'T FIND FILE file.ext 

The specified file could not be found. 



Example 



^R PRINT ) 

*TEST1.LST^ 

*TEST2.LST, TEST3.LST, TEST 1 .MAC /2 ) 

*tC 
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DIRECT (DIR) 



Function 



The DIRECT command list's the directory entries (filename, filename extension, size in 
blocks written, protection if file is on disk, and date created) specified by list. 



Command Format 



DIRECT list 



list = a single file specification or a string of file specifications separated 
by commas. This argument is optional . 

If list is omitted, DSK:*.* is assumed, and the directories in all file 
structures as defined by the job search list are listed, starting with the 
file structure name as a header. 

Two switches may be used with the DIRECT command: 

/F Lists short form of directory (i.e., filename 

and filename extension only). 

/L Lists on the line printer (LPT) instead of 

Teletype. 



Characteristics 



The DIRECT command: 

leaves the job in monitor mode, 
runs the DIRECT CUSP, 
is used with disk monitors only, 
requires LOGIN. 

Associated Messages 

Refer to Table 2-1 



Revision 1 Monitors 2-33 January 1971 



Examples 



^DIR DTA3: J 
jJD I R * • MA C J 

j^DIR TE-ST.F4C?7^60] ) 

-DIRECT ) 
DSKB: C 10,63] 



TOTAL BLOCKS 



Lists all files on DTA3 

Lists all files with MAC filename extension in 
all file structures in the job search list. 

Lists the directory entry for file TEST.F4 in 
user area 27,60. 



TEST 


F4 


01 


<155> 


U-SEP-70 


TEST1 


MAC 


01 


<055> 


1 l-SEP-70 



02 



R LOOKFL 



Function 



The R LOOKFL command types all the characteristics of a single disk file on the 
user's console. 



Command Format 
R LOOKFL 



The CUSP responds with the word FILE, and the user types the filename 
and filename extension of the file in which he is interested. 

FILE: dev:file, ext [proj,prog] 

The output is written on file TTY: LOOKFL. TXT. 



Characteristics 



The R LOOKFL command: 

returns console to monitor mode via EXIT, 
runs the LOOKFL CUSP, 
is used with disk monitors only, 
requires LOGIN. 
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Example 

^R LOOKFLj 

FILE: PIP.HGH J 

DPA0:PIP.HGH£10,63] 



ACCESS DATE; 12-SEP-70 

CREATION TIME, DATE: 1800 12-SEP-70 

ACCESS PRIVILEGS: 055 

MODE: 16" ~ 

WORDS WRITTEN: 3057. 

VERSION NUMBER: 0,0 

ESTIMATED LENGTHT~0~. 

BLOCKS ALLOCATED: 30. 

POSITION OF LAST ALLOCATION: 

NONPRIVILEGED CUSTOMER ARG: 00000000 0000 

TAPE LABElT ~ ~ 

STATUS SITS: 400000000000 

ERROR LOGICAL BLOCK: 

ERROR LOGICAL UNlf: 

NUMBER OF BAD BLOCKS: 0. 

AUTHOR: 10,63 ~ 

NEXT STR: 

PREVIOUS STR: 

PRIVILEGED CUSTOMER ARG: 000000000000 

DATA BLOCK IN UFD : 567 

EXIT 



R DMPFIL 



Function 

The R DMPFIL command prepares an octal dump of part or all of a user file. 

Command Formal 1 

.R DMPFIL 

*dev:ofile.ext -dev: ifile.ext/switch 

(continued on next page) 
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dev:ofile.ext - the output file. 

If dev: is omitted, LPT is assumed. 

If .ext is omitted, .LST is assumed. 

If ofile is omitted, ifile is assumed. 

If entire output specification (including «•) is omitted, 

LPT: ifile .LST is assumed. 

dev:ifile.ext/switch = the input file. 



If dev: is omitted, DSK is assumed. 



/switch - 



/nnnnnnD 
/nnnnnnK 
/nnnnnnH 
/nnnnnnF 

/nnnnnnS 



/nnnnnnT 



Dump DECtape beginning at block nnnnnn 
octal, includes listing of directory. 

Assume file is save tile, dump as core dump 
beginning at location nnnnnn. 

Assume file is high segment file, dump as 
core dump . 

Dump disk as a standard file, beginning 
at logical block nnnnnn. If nnnnnn is 0, 
the RIB is printed . 

Dump disk, beginning at logical block nnnnnn 
with respect to file structure or unit depending 
on input device name. If nnnnnn is 0, block 
is printed. User must be privileged since this 
operation uses a super USETI UUO, or the user 
must have mounted the file structure or pack 
as single access. 

Stop dump at nnnnnn octal . This switch may 
be combined with any of the above. 



The range of nnnnnn is from to //////. To terminate the dump in the middle of the 
operation, type tC and REENTER. This action closes the files properly. 



Characteristics 



The R DMPFIL command: 

places the console in user mode, 
runs the DMPFIL CUSP. 



Associated Messages 

? SYNTAX ERROR 

There is a syntax error in the command string . 
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Example 
^ASSIGN TTY LPT J 
TTY24 ASSIGNED 

^R DMPFIL J 

*P IP .HGH/4000 1 0H/400020T ) 

'DUMP OF FILE PIP.HGH/400010H TO 09-12-70 18:32 

400010 001073400010 474300000000 402000000157 205000637163 047000 
000055 200000404540 202000000257 2000B040552T 
400020 047000000041 
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FILE (FIL) 



Function 



The FILE command provides remote control of DECtape-to-disk and disk-to-DECtape 
transfers on operator -hand led DECtapes. 



Command Format 



FILE option 



option = F Files information onto a DECtape. Requires Tape ID and 

list of filenames as arguments. The tape ID is a decimal 
number (user's tape), P (project tape), or A (general tape). 
Upon completion, an automatic FILE L is performed. 

option = Z Zeroes the directory of the DECtape before the files are 

copied and then performs the same operations as the F 
option. After the files are copied, an automatic FILE L 
is performed. 

option = R Recalls (transfers) information from the user's DECtape to 

the disk. After the files are transferred, an automatic 
FILE L is performed. 

option = L Reads the directory of a DECtape and places it in the user's 

disk area as an ASCII file with filename tapen.DIR. Tapen 
is the number of the user's DECtape and is the only argument. 
The user may then read the directory with a monitor command 
string. (See Examples). 

option = C Checks the queue of FILE commands to be read to determine 

if any of the user's requests are still pending. No argument 
is required. Pending request will be listed. 

option = D Deletes the specified files from DECtape. Requires Tape ID 

and list of filenames as arguments. 

The C option is the only request that is performed immediately. The other 
requests are placed in a queue to be performed when possible. The user's 
console and job are free to proceed before the request is completed. The 
option argument is optional. If an argument is not specified, a brief 
dialogue is performed . 
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Characteristics 



The FILE command: 



leaves the console in monitor mode, 
runs the UMOUNT CUSP, 
is used with disk monitors only, 
requires a job number and LOGIN. 



Associated Messages 



NONE PENDING 

None of the user's requests is pending. 



Examples 



option = F 

_.FILE F..2, MAIN.F4jNAME.MACJ 
option = Z 

_.FILE Z,b TEST. MAC , JOBS. CBL J 

option = R 

^FILE R>2, *.MAC J 

option = L 

_.FILE L,l J 

The user may then read this directory with the monitor command string 
/TYPE 1 .DIR J 

option = C 

^FILE C J 

option = D 

•FILE Dj2, FILE1,FILE2.* J 
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R FILEX 



Function 



The R FILEX command runs the FILEX program. This program is a general file transfer 
program intended to convert between various core image formats, and to read and write 
various directory formats. Files are transferred as 36-bit data. The only processing on 
the data is that necessary to convert between various core image representations . 

Command format 

.RFILEX^ 
| *dev:ofile.ext [pro}, prog] <nnnVswitches-dev:ifile.ext [proj,prog KnnnVsw itches 

If the project-programmer and/or the switches appear after the device 
name, they apply to all the following files. If they appear after the 
filename, the specifiers apply only to the preceding file. The input 
filename or extension may be * in which case the usual processing of 
the * construction occurs (refer to the TYPE command). The output 
filename and extension may be * in which case the filename and ex- 
tension of the input file is copied. If the output filename or extension 
is missing, the same procedure occurs as with the * construction, ex- 
cept that all core image files are written with the default extension 
and format appropriate to the output device (unless overridden by 
switches). 

If a protection <nnn> is not specified, files are written with the system 
standard protection unless the files are being written on SYS. On SYS. , 
files are written with protection <I55>, except for files with extension 
. SYS. These files have the default protection of <157>. 

Meaning of Switches: 

DECtape Format Specifiers 

/M - MIT project MAC PDP-6/10 DECtape format 
/O - Old DEC PDP-6 DECtape format 
/T - normal PDP-10 directory format 

File Format Specifiers 

/B - binary processing; overrides default extension. 

/C - compressed; save file format. This format is assumed 
for files with extensions .SAV, .LOW, .SVE. The 
default output extension is .SAV unless the input 
extension is .LOW or .SVE, in which case the ex- 
tension remains unchanged. . . , . 

(continued on next page) 
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Hie format Specifiers (Cont) 

/D - dump format. This format is assumed for files with 
extension .DMP. 

/E - expanded core image files (used by FILDDT). This format 
is assumed for files with extension .XPN. The default 
output extension is .XPN. 

/S - simple block (SBLK) format, project MAC's equivalent 
of .SAV format. The default output extension is .BIN. 

DECtape Processing Specifiers 

/G - (go on), ignores read errors on input device. FILEX 
checks the always-bad-checksum bit in the 5-series 
monitor, so this switch is not needed for files with 
.RPABC on (e.g. CRASH. SAV). 

/L - (list), causes a directory on an input DECtape file to be 
typed on the Teletype, or causes a directory listing of 
the output DECtape at the end. 

/P - (preserved) , causes quick processing (/Q) and preserves 

the scratch file after processing for use by another command. 

/Q - (quick), causes an input DECtape to be processed quickly via 
a scratch file. 

/R - (reuse), reuses a scratch file preserved by a /P in a previous 
command . 

/7. - (zero) , causes the appropriate format of a zeroed directory 
to be written on a DECtape output file. If TAPEID appears 
in the output specifier, then TAPEID is written as the tape 
identifier in the directory . TAPEID may be 6 characters 
on a PDP-10 tape, 3 characters on a project MAC tape, 
and is not present on a PDP-6 tape . 



Characteristics 



The R FILEX command: 

runs the FILEX CUSP. 



Examples 



•R FILEX^ The dump format file is com- 

5>SK:-DTA1 :TEST.DMP/C pressed and written as 

TEST. SAV. 

.R FILEX 

*bSK:SER105.SAVE10,10 3/E-DSKC:CRASH.SAVtl,4 3 Co Py CRASH. SAV to an ex- 
panded format file for FILDDT 
to examine. 
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R SETSRC 



Function 



The R SETSRC command runs the SETSRC CUSP to manipulate the job's file structure 
search list (refer to Paragraph 6.2.7). The file structure search list defines the order 
of search whenever device DSK is explicitly or implicitly specified by the user. 



Command Format 



R SETSRC 

The CUSP responds with 

TYPE H FOR HELP 

The user may respond with 

C J to create a new search list. 

T J to type the current search list. 

Hi to get information about commands to be typed . 

The current search list is typed in the form 

fsl/s/s,fs2/s/s, . . .,FENCE,. . .,fs9/s/s 

fsl is the name of the first file structure. 

/s is one or more of the following switches: 

/C for create 
/N for no create 
/R for read only 
/W for writeable 

If no switches are specified, /C and /W are assumed. 

/N indicates that the monitor is not to create files on this file structure when 
device DSK is specified. The user must specify the file structure name ex- 
plicitly. This switch is useful when users have a small space on a fast file 
structure and a large space on a slow file structure. If /N is associated with 
the smaller file structure, all files are created on the larger file structure 
unless the smaller file structure is specified. 

To create a new search list, type in the new search list (up to the FENCE) in 
the same form as it is typed out. The monitor moves the file structures that 
were in the old search list but that were not specified in the new search list 
to after the FENCE, thereby never decreasing the number of file structures 
that the user intends to use. 

NOTE 
Since the MOUNT command creates a UFD, 
it should be used to attach a new file structure 
to the search list. 
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Characteristics 



The R SETSRC command: 

places the console in the user mode, 

runs the SETSRC CUSP, 

requires LOGIN and a job number. 



Associated Messages 



None 



Example 



_.R SETSRC J 
*T J 

DSKBj FENCE 

*C DSKAjDSKB J 

DSKA, DSKB, FENCE 
*C DSKBj 

DSKB, FENCE* DSKA 



R ALCFIL 



Funct 



ion 



The R ALCFIL command runs the ALCFIL CUSP to allocate space for a new file or re- 
allocate space for an existing file on the disk in one contiguous region. The size of 
the region is restricted by the size of the cluster count field (usually 512) times the 
cluster size of the file structure. 
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Command Format 



R ALCFIL 

The CUSP responds with 

/H FOR HELP 
FILE? 

The user may respond with 

dev:fi le . extCproj . prog .] 
or /H (for help) 
or A (to exiO 

where dev: is a file structure or physical unit name. If dev: is omitted DSK 
is assumed. If one of the other arguments is omitted, is assumed. If a 
filename is specified, the number of blocks presently allocated, if non-zero, 
is typed. ALCFIL responds 

ALLOCATE? 

User may type N or N,M (decimal numbers) 

N = total number of blocks to be allocated for the file. 
M = logical block within the file structure or unit (depending 
on dev:) where the allocation is to begin. 

If the new blocks cannot be allocated, an error message is given and ALCFIL 
begins again. If the new blocks can be allocated, the message 

ALLOCATED 

is typed. 

Since an extended ENTER (refer to Paragraph 6.2.8.2) is executed to allocate 
the new blocks, the file need not exist before allocating the blocks. 



Characteristics 



The R ALCFIL command: 

places the console in user mode, 

runs the ALCFIL CUSP, 

requires LOGIN and a job number. 



Associated Messages 



BLOCK NOT FREE 

M specifies a unit or file structure logical block that is not free. 

n BLOCKS ALREADY ALLOCATED 

The file already exists. The new specification replaces the old specification, 
rather than updating the old. 
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Associated Messages 

Refer to Table 2-1 



Example 



^RENAfF Tl 1 .KAC=T1 .tfAC ) 

FILES renamed; 
Tl .MAC 



^RENAME *.BAK = *.i*AC J 
FILES RENAMED: 
Tl 1 .MAC 



T2.t"iAC 
T3.KAC 



CREF (CREF) 



Function 



The CREF command runs CREF and lists on the line printer any CREF listing files 
generated by previous COMPILE, LOAD, EXECUTE, and DEBUG commands using 
the /CREF switch since the last LOGIN . The file containing the names of these 
CREF-listing files is then deleted so that subsequent CREF commands will not list 
them again. If the logical device name LPT is assigned to DSK, the CREF files 
are converted to LST files with the same filenames. 



Command Format 



CREF 



Characteristics 



The CREF command: 



leaves the console in monitor mode, 
runs the COMPIL CUSP, 
is used with disk monitors only, 
requires LOGIN. 
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Associated Messages 



Refer to Table 2-1 



Example 



.CREF J 



2.7 COMPILATION COMMANDS 

Each time a COMPILE, LOAD, EXECUTE, or DEBUG command is executed, the command with its 
arguments is remembered as a file on the disk or in core if the monitor has the TMPCOR feature imple- 
mented; therefore, the filename used last may be recalled for the next command without specifying the 
arguments again. (Refer to last paragraph in Section 2.5.) 



COMPILE (COM) 



Function 



The COMPILE command produces relocatable binary file(s) for the specified program(s). 
The use of the MACRO assembler, COBOL compiler, and/or the FORTRAN IV compiler 
is determined as follows. 



Condition 

If no .REL (binary) file 

If source-file [date, time] 
is later than or equal to 
binary-file [date, time] 

If other than above 



Source File Extension 

.MAC 

.F4 

.CBL 

Other than above, or null 



Actic 



Translate source file 
Translate source file 



Do not translate source file; 
use current .REL (binary) file. 

Translator Used 

MACRO assembler 

FORTRAN IV compiler (F40) 

COBOL compiler 

"Standard processor" is used (see 2.7.2) 
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Command Format 



COMPILE list 



list = a single file specification, or a string of file specifications separated 
by commas. 



Characteristics 



The COMPILE command: 

leaves the console in monitor mode, 
runs the COMPIL CUSP, 
is used with disk monitors only, 
requires LOGIN. 



Restrictions 

The * construction may not be used. 

Associated Messages 



Refer to Table 2-1 
Example 



.COMPILE PROGA^ 



LOAD (LOA) 



Function 



The LOAD command performs the COMPILE function for the specified program(s), then 
runs LOADER and loads the .REL files. 



Command Format 



LOAD list 



list = a single file specification, or a string of file specifications separated 
by commas. 
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Characteristics 



The LOAD command: 



leaves the console in monitor mode, 
runs the COMPIL CUSP, 
is used with disk monitors only, 
requires LOGIN. 



Associated Messages 



Refer to Table 2-1 



Example 



_;_LOAD FILEA,FILEB>%60000FILEC J 



Pass origin switch to Loader; refer to 
Paragraph 2.7.4. 



^LOAD 

NACRO: 


TEST J 
TEST 


LOADING 




LOADER 


IK 


CORE 


EXIT 







EXECUTE (EX) 



Function 



The EXECUTE command performs the COMPILE and LOAD functions for the specified 
program(s) and begins execution of the loaded program. 



Command Format 



EXECUTE list 



list = a single file specification or a string of file specifications separated 
by commas. 
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Characteristics 



The EXECUTE command: 

places the console in user mode, 
runs the COMPIL CUSP, 
is used with disk monitors only, 
requires LOGIN. 



Associated Messages 



Refer to Table 2-1 



Example 



jKX TEST J 
MACRO: TEST 
LOADING 



LOADER IK CORE 
EXECUTION 



DEBUG (DEB) 



Function 



The DEBUG command performs the COMPILE and LOAD functions and, in addition, 
prepares for debugging. DDT (the Dynamic Debugging Technique program) is loaded 
first, followed by the user's programs with local symbols. DDT is entered on com- 
pletion of loading. 



Command Format 



DEBUG list 



list = a single file specification or a string of file specifications separated 
by commas. 
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Characteristics 



The DEBUG command: 



places the console in user mode, 
runs the COMPIL CUSP, 
is used with disk monitors only, 
requires LOGIN. 



Associated Messages 

Refer to Table 2-1 

Examples 



•DEBUG/L FILFAjF ILFH*F ILF..C/N>FILFD Generate listings for FILEA, 

~ FILEB, and FILED; refer to 

Paragraph 2.7.2. 

_.DEBUG TEST ) 
^ACRO: TEST 
LOADING 



LOADER 2K CORF 
EXECUTION 



./ BLT 1 5>0 C 1 6) 



2.7.1 Extended Command Forms 



The commands previously explained are adequate for the compilation and execution of a single pro- 
gram or a small group of programs at one time. However, the assembly of large groups of programs, 
such as the FORTRAN library or the Timesharing Monitor, is more easily accomplished by one or more 
of the extended command forms. 

2.7. 1 . 1 Indirect Commands (@ Construction) - When there are many program names and switches, 
they can be put into a file; therefore, they do not have to be typed in for each compilation. This is 
accomplished by the use of the @ file construction, which may be combined with any COMPIL-class 
commands. 

The @ file may appear at any point after the first word in the command. In this construction, the word 
file must be a filename, which may have an extension and project-programmer numbers. If the exten- 
sion is omitted, a search is made for the command file with a null extension and then for a command 
file with the extension .CMD. The information in the command file specified is then put into the com- 
mand string to replace the characters @ file. 
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For example, if the file FUST contains the string 

FILEEUF I LEC /LIST* FILED 

then the command 

.COMPILE FILEA,EILEB,FILEC/LIST>FILED,EILEZ 

could be replaced by 

•COMPILE FILEA, DELIST, EILE2 

Command files may contain the @ file construction to a depth of nine levels. If this indirecting process 
results in files pointing in a loop, the maximum depth is rapidly exceeded and an error message is pro- 
duced . 

The following rules apply in the handling of format characters in a command file. 

a. Spaces are used to delimit words but are otherwise ignored. Similarly, the 
characters TAB, VTAB, and FORM are treated like spaces. 

b. To allow long command strings, command terminators (CARRIAGE RETURN, 
LINE FEED, ALTMODE) are ignored if the first nonblank character after a 
sequence of command terminators is a comma. Otherwise, they are treated 
either as commas by the COMPILE, LOAD, EXECUTE, and DEBUG commands 
or as command terminators by all other COMPIL-class commands. 

c. Blank lines are completely ignored because strings of returns and line-feeds 
are considered together. 

d. Comments may be included in command files by preceding the comment with 
a semicolon. All text from the semicolon to the line-feed is ignored. 

e. If command files are sequenced, the sequence numbers are ignored. 

2.7. 1 .2 The + Construction - A single relocatable binary file may be produced from a collection of 
input source files by the "+" construction. For example: a user may wish to compile the parameter 
file, S.MAC, the switch file, FT50S.MAC, and the file that is the body of the program, 
COMCON.MAC. This is specified by the following command: 

•COMPILE S+FT50S+COMCCN 



"Used in COMPILE, LOAD, EXECUTE, and DEBUG commands only. 
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The name of the last input file in the string is given to any output (.REL, .CRF, and/or .LST) files 
(e.g., COMCON. in the preceding example). The source files in the "+" construction may each con- 
tain device and extension information and project-programmer numbers. 

2.7. 1.3 The = Construction - Usually the filename of the relocatable binary file is the same as that 
of the source file, with the extension specifying the difference. This can be changed by the "=" con- 
struction, which allows a filename other than the source filename to be given to the associated output 
files. For example: if a binary file is desired with the name BINARY. REL from a source program with 
the name SOURCE. MAC, the following command is used. 

•COMPILE BINARY=SOURCE 

This technique may be used to specify an output name to a file produced by use of the "+" construc- 
tion. To give the name WHOLE. REL to the binary file produced by PARTI .MAC and PART2.MAC, 
the following is typed. 

•COMPILE WH0LE=PART1+PART 2 

Although the most common use of the "=" construction is to change the filename of the output files, 
this technique may be used to change any of the other default conditions. The default condition for 
processor output is DSK:source.REL[selfl . For example: if the output is desired on DTA3 with the 
filename FILEX, the following command may be used: 

EXECUTE DTA3:FILEX=FILE1 .F4 

2.7. 1 .4 The < > Construction - The < > construction causes the programs within the angle brackets 
to be assembled with the same parameter file. If a + is used, it must appear before the < > construc- 
tion. For example: to assemble the files LPTSER.MAC, PTPSER.MAC, and PTRSER.MAC, each with 
the parameter file S.MAC, the user may type 

.COMPILE S+LPTSER* S+PTPSERj S+PTRSER 

With the angle brackets, however, the command becomes 

•COMPILE S+<LPTSERjPTPSER,PTRSER> 



^sed in COMPILE, LOAD, EXECUTE, and DEBUG commands only. 
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The user cannot type 

.compile <lptsek,ptpser..ptrser>+s 

2.7.2 Compile Switches 

The COMPILE, LOAD, EXECUTE, and DEBUG commands may be modified by a variety of switches. 
Each switch is preceded by a slash and is terminated by any non-alphanumeric character, usually a 
space or a comma. An abbreviation may be used if it uniquely identifies a particular switch. 

These switches may be either temporary or permanent. A temporary switch is appended to the end of the 
filename, without an intervening space, and applies only to that file. 

Example: 

•CO'PILF. A»R/fACRO*C (The MACRO assembler applies only to file B.) 

A permanent switch is set off from filenames by spaces, commas or any combination of the two. It 
applies to all the following files unless modified by a subsequent switch. 

Example: 

.CO-PILF /MACRO A,B*C 

• COMPILE A /MACRO B,C 
•COMPILE A,/MACRO.»B,C 

• COMPILE A, /MACRO B>C 

2.7.2. 1 Compilation Listings - Listing files may be generated by switches. The listings may be of 
the ordinary or the cross-reference type. The operation of the switch produces a disk file with the ex- 
tension .LST. 

The compile-switches LIST and NOLIST cause listing and nonlisting of programs and may be used as 
temporary or permanent switches. 

Listings of all three programs are generated by 
•COMPILE /LIST A,B,C 

A listing only of program A is generated by 

.CCfPILE A/LIST, B*C 



^Used in COMPILE, LOAD, EXECUTE, and DEBUG commands only. 
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Listings of programs A and C are generated by 

•COMPILE /LIST A,b/NOLIST*C 

The compile-switch CREF is like LIST, except that a cross-reference listing is generated, to be 
processed later by the CREF CUSP. 

Unless the /LIST or /CREF is specified, no listing file is generated. When listing files are generated, 
the LIST and CREF commands can then be used to obtain printer output of the listing files. 

Since the LIST, NOLIST, and CREF switches are commonly used, the switches L, N, and C are de- 
fined with the corresponding meanings, although there are (for instance) other switches beginning with 
the letter L. Thus, the command 

•COMPILE /L A 
produces a listing file A.LST (and A.REL). 

2.7.2.2 Standard Processor - The standard processor is used to compile or assemble programs that do 
not have the extensions .MAC, .CBL, .F4, or .REL. A variety of switches set the standard processor. 
If all source files are kept with the appropriate extensions, this subject can be disregarded. 

If the command 

•COMPILE A 

is executed and there is a file named A. (that is, with a blank extension), then A. will be translated 
to A.REL by the standard processor. Similarly, if the command 

•COMPILE FILE. NEW 

is executed, the extension .NEW, although meaningful to the user, does not specify a language; 
therefore, the standard processor is used. The user must be able to control the setting of the standard 
processor which is FORTRAN IV at the beginning of each command string. 

The standard processor may be changed by the following compile-switches: 
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COBOL change standard to COBOL 

C same as COBOL 

MACRO change standard to MACRO 

M same as MACRO 

FORTRAN change standard to FORTRAN IV 

F same as FORTRAN 

REL change standard to use relocatable binary; i.e., use existing 

.REL files, although a newer source file may be present 
(useful primarily in LOAD, EXECUTE, DEBUG commands). 

These switches may be temporary or permanent. For example: assume that programs A, B, and C exist 
on the disk, with blank extensions. Then 

•COMPILE A,B/!*jC 

will cause A and C to be translated by FORTRAN, B by MACRO. Also, 

.COMPILE A>/M B*C 

will cause A to be translated by FORTRAN, B and C by MACRO. 

NOTE 

Programs with .MAC, .CBL, and ,F4 extensions are 
always translated by the extension implied, regardless 
of the standard processor unless forced by a temporary 
switch. 



2.7.2.3 Forced Compilation - Compilation (or assembly) occurs if the source file is at least as recent 
as the relocatable binary file. The creation time for files is kept to the nearest minute. Therefore, it 
is possible for an unnecessary compilation to occur. If the binary is newer than the source, the trans- 
lation does not usually have to be performed. 

There are cases, however, where such extra translation may be desirable (e.g., when a listing of the 
assembly is desired). To force such an assembly, the switch COMPILE is provided, in temporary and 
permanent form. For example: 

.COMPILE /CREF/COMPILE A,B,C 

will create cross-reference listing files A.CRF, B.CRF, and C.CRF, although current .REL files may 
exist. The binary files will also be recreated. 
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The corresponding switch NOCOMPILE is also provided, to turn off the forced-compile mode. Note 
that this differs from the /REL switch, which turns off even the normal compilation caused by a source 
file that is newer than the .REL file. 

2.7.2.4 Library Searchest - The LOADER normally performs a library search of the FORTRAN library. 
If it is necessary to search other files as libraries, the compile-switches LIBRARY and NOSEARCH 

(its complement) are provided. The switch /LIBRARY (equivalent to /LIB) signifies that all files to 
which it applies are searched in library search mode. The switch /NOSEARCH (equivalent to/N) 
signifies that all routines of the file to which it applies are loaded regardless of whether the routines 
are referenced or not. This is the normal loading mode, and the /NOSEARCH is used only to turn off 
the library search mode. Note that /NOSEARCH is not equivalent to /P of the Loader. 

For example: if a special library file named SPCLIB.REL were kept on device SYS at a particular in- 
stallation, to compile and load a user program, library search the special library, and search the nor- 
mal FORTRAN library, the following command could be used: 

.LOAD KAIN,SYS:SPCLIB/LIB 

At this point, it should be noted that the program SPCLIB is not assembled simply because its source 
file is presumably not on device SYS. The COMPILE process will compile any program named in the 
command string, if its source is present and not older than the .REL file, unless prevented by the /REL 
switch. 

2.7.2.5 Loader Maps - Loader maps are produced during the loading process by the compile-switch 
MAP. When the MAP switch is encountered, a loader map is requested from the loader. After a 
library search of LIB40, the map will be written with default filename MAP. MAP, in the user's disk 
area. An optional filename, preceded by a colon, may be specified after the MAP switch . 

The MAP compile-switch is the one exception to the permanent compile-switch rule, in that it causes 
only one map to be output, although it may appear as a permanent switch. 

| .LOAD CAIN, SUB /KAPrN'AIN 

2.7.3 Processor Switchestt 

Occasionally it is necessary to pass switches to the assembler or compiler. For each translation 
(assembly or compilation), a command string is sent to the translator containing three parts: the source 
files, a binary output file, and a listing file. To add switches to those files, the user must: 



tFor more LOADER information, refer to the LOADER documentation in the PDP-10 Reference 
Handbook „ 

ttUsed in COMPILE, LOAD, EXECUTE, and DEBUG commands only. 
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a. If the + construction is used, group the switches according to each related source 
Filename. 

b. Group the switches according to the three types of files (source, binary, and listing) 
for each source filename. 



c. For each source filename, separate the groups of switches by commas. 

d. Enclose all the switches for each source filename within one set of parentheses. 

(SSSS) Only source switches are present 

(SSSS,BBBB) Source and binary switches are present 

(SSSS,BBBB,LLLL) Source, binary, and listing switches are present. 

e. Place each parenthesized string immediately after the source filename to which it refers. 



Examples: 



•DEBUG TESTCN) 



.COMPILE OUTPUT=MTA0:<W,S,M)/L 



•COMPILE /MACRO A=MTA0 : CW, ,Q >/L 



•COMPILE /MACRO A=MTA0:(,,Q)/L 



Suppress typeout of errors during 
assembly. 

Rewind the magtape (W), compile 
the first file, produce binary output 
for the PDP-6(S), and eliminate the 
MACRO coding from the output list- 
ing (M). Output files are given the 
names OUTPUT .REL and 
OUTPUT. LST. 

Rewind the magtape (W), compile the 
first file, and suppress Q (question- 
able) error indications on the listing. 
Note that when a binary switch is not 
present, the delimiting comma must 
appear. 

Compile file at current position of 
the tape and suppress Q error indica- 
tions on the listing. Note that when 
the source and binary switches are not 
present, the delimiting comma must 
appear. 



2.7.4 Loader Switches 



In usually complex loading processes, it may be necessary to pass loader-switches to the LOADER to 
direct its operation. This is accomplished by the % character. The % has the same meaning as that 
of the / in the Loader's command string. Also, like the /, the % takes one letter (or a sequence of 
digits and one letter) following it. Therefore, to set a program origin of 6000 for program C, the user 
types 

•LOAD A,B,%60000OC*D 

COMPIL allows more than one loader switch to be specified. For example, 

•LOAD PROG %F/MAP 
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The most commonly used switches are: 

a. %S Load with symbols 

b. %nO Set program origin to n 

c. %F Cause early search of FORTRAN library 

d. %P Prevent FORTRAN library search. 

2.7.5 Temporary Files 

The COMPIL CUSP deciphers the commands found in Tables 2-3 and 2-5 and constructs new commands 
for the referenced CUSPs. These new commands are written as temporary files in core or, if the 
TMPCOR area is full, on the disk, as are all of the monitor-level commands. COMPIL and the other 
CUSPs transfer control directly to one another without requiring additional typed-in commands from 
the user. 

Temporary filenames have the following form: 
nnnxxx.TMP 

where nnn is the user's job number in decimal, with leading zeros to make three digits and xxx speci- 
fies the use of the file. In the filenames listed below, job number 1 will be assumed. 

2.7.5. 1 001SVC.TMP - This file contains the most recent COMPILE, LOAD, EXECUTE, or DEBUG 
command that included arguments. It is used to remember those arguments. (Refer to Paragraph 2.7.) 

2.7.5.2 001EDS.TMP - This file contains the most recent EDIT, CREATE, TECO, or MAKE command 
that included an argument. It is used to remember that argument. (Refer to Paragraph 2.5.) 

2.7.5.3 001MAC.TMP - This file contains commands to MACRO. It is written by COMPIL, and 
read by MACRO. It contains one line for each program to be assembled, and (if required) the command 

NAME! 
to cause MACRO to transfer control to the named CUSP ("name" may be F40, LOADER). 

2.7.5.4 001FOR.TMP - This file corresponds to the one described in the preceding section, except 
that it is read by the FORTRAN IV compiler, F40. 
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2.7.5.5 001COB.TMP - This file corresponds to the one described in Paragraph 2.7.5.3, except 
that it is read by the COBOL compiler. 

2.7.5.6 001PIP.TMP - This file is written by COMPIL and read by PIP. It contains ordinary PIP com- 
mands to implement the DIRECTORY, LIST, TYPE, RENAME, and DELETE commands. 

2.7.5.7 001CRE.TMP - This file is written by COMPIL and read by CREF. It contains commands to 
CREF corresponding to each file which has produced a CREF listing on the disk. 

COMPIL also reads this file, if it exists, each time a new CREF listing is generated, to prevent 
multiple requests for the same file, and to prevent discarding other requests that may not yet have been 
listed. 



2.7.5.8 001EDT.TMP - This file is written by COMPIL for each EDIT, CREATE, TECO, or MAKE com- 
mand, and is read by either the LINED or TECO CUSP. 

For the commands MAKE or CREATE, it contains the command 
EW file.ext 0© or Sfile.ext © 

For the commands TECO or EDIT, it contains the command 
EBfile.ext ($)($) or Sfile.ext J I 



2.7.5.9 001LOA.TMP - This file is written by COMPIL and contains commands to LOADER that are 
necessary for loading programs. 

2.8 RUN CONTROL COMMANDS 

By using a run control command, the user can load core image files from retrievable storage devices 
(i.e., disk, DECtape, magnetic tape). These files can be retrieved and controlled from the user's 
console. Files stored on disk and DECtape are addressable by name. Files on magnetic tape require 
the user to preposition the tape to the beginning of the file. (Refer to Table 3-1 for the description of 
job data area locations referenced by commands below.) 
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RUN (RU) 



Function 



The RUN command loads a core image from a retrievable storage device and starts it at 
the location specified within the file (JOBSA). 

If the program has two segments, both the low and high segments are set up. If the 
high file has extension . SHR (as opposed to .HGH), the high segment will be shared. 
A two-segment program may have a low file extension (.LOW). 

The RUN command clears all of core. However, programs should not count on this 
action and must still initialize core to the desired value to allow programs to be re- 
started by a tC, START sequence without having to do I/O. 



Command Format 



RUN dev:file.ext [ pro j, prog] core 

dev: = the logical or physical name of the device containing the core 
image. The default device name is DSK: The colon following the 
device name is required. 

file.ext = the name of the file containing the core image; .ext applies 
to the low file, not the high file. An extension of .SHR, then .HGH, 
is assumed for the high file. If the user types an extension of .SHR or 

• HGH, the extension is treated as a null extension since .SHR and 

• HGH are confusing as low file extensions. The default filename is 
the job's current name as set by the last R,RUN, GET, SAVE, or 
SSAVE command, the last SETNAM UUO, or the last command which 
ran a CUSP. 

[pro}, prog] = the project-programmer number; required only if core 
image file is located in a disk area other than the user's. 

core = the amount of core to be assigned to the sum of the low and 
high segments if different from minimum core needed to load the pro- 
gram or from the core argument of the SAVE command which saved 
the file. 

If core < the minimum low segment size, then an error message occurs. 

If core >the minimum low segment size and <the sum of the high seg- 
ment and the minimum low segment size, then the core assignment is 
the low segment size. 

If core > the sum of the minimum low segment and the high segment 
size, then the core assignment is the size of both the low and high 
segments to be used. 

Since previous core is returned, MTA must have the core argument 
because there is no directory telling how much core is for the low 
segment. Refer to Paragraph 2.8.1 . 
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Characteristics 



The RUN command: 



places the console in user mode, 
requires a job number and LOGIN. 



Restrictions 



On systems with a large amount of core memory, the user should not specify a core 
argument that forces the high segment to start higher than 400000 unless the programs 
high segment is self-relocating. If this is done, the ILLEGAL UUO error message is 
likely to occur. 



Associated Messages 



?dev: NOT AVAILABLE 

The device has been assigned to another job. 

?NO SUCH DEVICE 

The device does not exist in this monitor configuration. 
?nK OF CORE NEEDED 

There is insufficient free core to load the file. 

?NOT A SAVE FILE 

The file is not a core image file. 

7TRANSMISSION ERROR 

A parity or device error occurred during loading. 

?file.ext NOT FOUND 

The program file requested cannot be found on the specified device. 

?NO START ADR 

Starting address was because the user failed to specify a starting address 
in the END statement of the source program. 

?ADDRESS CHECK FOR DEVICE dev 

The save file is too large for the core assigned. 
?LOOK UP FAILURE n 

The LOOKUP to read the file failed, n is the disk error code (refer to 
Appendix E). 



Examples 



.RUN DSK:TEST ) 
_.RUN DSK:HISTST [10,633^ 
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MR) 



Function 



The R command is the same as RUN SYS:file.ext core. This command is the usual way 
to run a CUSP that does not have a direct monitor command to run it. 

This command clears all of core. However, programs should not count on this action 
and must still initialize core to the desired value to allow programs to be restarted 
by a tC, START sequence without having to do l/O. 



Command Format 



R file.ext core 



Arguments are the same as in the RUN command except that SYS: is used as 
the default device. 

The extension applies to the low file, not the high file. An extension of 
. SHR, then . HGH, is assumed for the high file. If the user types an ex- 
tension of .SHR or .HGH, the extension is treated as a null extension 
since .SHR and .HGH are confusing as low file extensions. 



Characteristics 



The R command: 



places the console in user mode, 

runs a CUSP, 

requires a [ob number and LOGIN. 

Associated Messages 

?dev: NOT AVAILABLE 

The device has been assigned to another job . 

?NO SUCH DEVICE 

The device does not exist in this monitor configuration. 

?nK OF CORE NEEDED 

There is insufficient free core to load the file. 

?NOTA SAVE FILE 

The file is not a core image file. (continued on next page) 
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Associated Messages (Cont) 

7LOOKUP FAILURE n 

The LOOKUP to read the file failed, n is the disk error code (refer to 
Appendix E). 

7TRANSMISSION ERROR 

A parity or device error occurred during loading . 

?file.ext NOT FOUND 

The program file requested cannot be found on the specified device. 

? NO START ADR 

Starting address was because the user failed to specif/ a starting address 
in the end statement of the source program . 

? ADDRESS CHECK FOR DEVICE dev 

The save file is too large for the core assigned. 

Examples 

~~ *R PIP,) 

* 
7r PIP 5 J 

* 



GET (G) 



Function 



The GET command is the same as the RUN command except that the monitor types out 

JOB SETUP 

and does not start execution . 

This command clears all of core. However, programs should not count on this action 
and must still initialize core to the desired value to allow programs to be restarted 
by a tC, START sequence without having to do I/O. 
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Command format 



GET dev:file.ext [ pro j. prog] core 

The arguments and the defaults are the same as in the RUN command. 

The extension applies to the low file, not the high file. An extension 
of .SHR, then .HGH, is assumed for the high file. If the user types an 
extension of .SHR or .HGH, the extension is treated as a null extension 
since .SHR and .HGH are confusing as low file extensions. 



Characteristics 



The GET command: 



leaves the console in monitor mode, 
does not allow an active device, 
requires a job number and LOGIN. 



Associated Messages 



?dev: NOT AVAILABLE 

The device has been assigned to another job. 

?NO SUCH DEVICE 

The device does not exist in this monitor configuration. 

?nK OF CORE NEEDED 

There is insufficient free core to load the file. 

?NOTA SAVE FILE 

The file is not a core image file. 

?TRANSMISSION ERROR 

A parity or device error occurred during loading . 

?file.ext NOT FOUND 

The program file requested cannot be found on the specified device. 

?ADDRESS CHECK FOR DEVICE dev 

The save file is too large for the core assigned. 

?LOOK UP FAILURE n 

The LOOKUP to read the file failed, n is the disk error code 
(refer to Appendix E) . 



Example 



^GET SYS:PIP^) 
JOB SETUP 

^GET TEST^ 
JOB SETUP 
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START (ST) 



Function 



The START command begins execution of a program previously loaded with the GET 
command. The old program counter is copied from JOBPC to JOBOPC. 



Command Format 



START adr 



adr = the address at which execution is to begin if other than the location 
specified within the file (JOBSA). This argument is optional. If adr is 
not specified, the starting address comes from JOBSA. 



Characteristics 



The START command: 



places the console in user mode, 
does not allow an active device, 
requires core, 
requires a job number and LOGIN. 



Associated Messages 



?NO CORE ASSIGNED 

No core was allocated to the user when the GET command was given, and 
no core argument was specified in the GET. 

?NO START ADR 

Starting address was because the user failed to specify a starting address 
in the END statement of the source program. 



Example 



• START J 
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HALT (tC) 



Function 



The HALT (tC) command transmits a HALT command to the monitor command inter- 
preter. It stops the job and stores the program counter in the job data area (JOBPC). 
Refer to Paragraph 2.1.1). 



Command Format 
HALT (tC) 

Characteristics 



The HALT (tC) command: 

places the console in monitor mode. 



Associated Messages 
None 

Example 

TC 
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CONT (CON) 



Function 



The CONT command starts the program at the saved program counter address stored 
in JOBPC by a HALT command (tC) or a HALT instruction. 



Command Format 
CONT 

Characteristics 



The CONT command: 



places the console in user mode, 

requires core, 

requires a job number and LOGIN. 

Associated Messages 

?CAN"T CONTINUE 

The Job was halted due to a monitor-detected error and cannot be continued. 

Example 

• CONT ) 
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JCONT 



Function 



The JOB CONTINUE command forces a continue of the specified job if the job was 
in a tC state because of a call to the device error message routine (HNGSTP). 



Command format 



JCONT y 

y = the number of the job to be continued. This argument is required. 



Characteristics 



The JCONT command: 

places the console in monitor mode 

Associated Messages 

?NOT A JOB 

The job specified does not exist. 

? JOB NOT WAITING 

The job specified is not waiting to be continued. 

CONT BY OPR 

The job has been continued by the operator . 

Example 



Revision 1 Monitors 2-68a January 1971 



DDT (DD) 



Function 



The DDT command copies the saved program counter value from JOBPC into JOBOPC 
and starts the program at an alternate entry point specified in JOBDDT (beginning 
address of DDT as set by Linking Loader). DDT contains commands to allow the user 
to start or resume at any desired address. 



Command Format 
DDT 

Characteristics 



The DDT command: 



places the console in user mode, 

requires core, 

requires a job number and LOGIN. 



Associated Messages 



?NO START ADR 

DDT starting address was (JOBDDT). 



Example 



• DDT ) 
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REENTER (REE) 



Function 



The REENTER command is similar to the DDT command. It copies the saved program 
counter value from JOBPC into JOBOPC and starts the program at an alternate entry 
point specified in JOBREN (must be set by the user or his program). 



Command Format 
REENTER 

Characteristics 



The REENTER command: 

places the console in user mode, 

requires core, 

requires a job number and LOGIN. 



Associated Messages 

?NO START ADR 

REENTER starting address was (JOBREN). 

Example 
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E(E) 



Function 

The E command examines a core location in the user's area (high or low segment). 

Command Format 



E adr 



Adr is required the first time the E or D command is used. If adr is 
specified, the contents of the location are typed out in half-word 
octal mode. 

If adr is not specified, the contents of the location following the 
previously specified E adr or the location of the previous D adr 
(whichever was last) are typed out. 



Characteristics 



The E command: 



leaves the console in monitor mode, 

requires core, 

requires a job number and LOGIN. 



Associated Messages 



?OUT OF BOUNDS 

The specified adr is not in the user's core area. 



Example 



iE 1 40 J 

000140/ 264000 002616 

000141/ 000000 000000 

000142/ 000000 000000 



• fc. 
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D(D) 



Function 

The D command deposits information in the user's core area (high or low segment). 

Command Format 



D Ih rh adr 



Ih = the octal value to be deposited in the left half of the location. 
This argument is required. 

rh = the octal value to be deposited in the right half of the location. 
This argument is required . 

adr = the address of the location into which the information is to be 
deposited. This argument is optional. 

If adr is omitted, the data is deposited in the location following the 
last D adr or in the location of the last E adr (whichever was last). 



Characteristics 



The D command: 



leaves the console in monitor mode, 

requires core, 

requires a job number and LOGIN. 



Associated Messages 



?OUT OF BOUNDS 



The specified adr is not in the user's core area, or the high segment is 
write protected and the user does not have write privileges to the file 
that initialized the high segment. 



Example 



.D 366000 2616 140 



*_E 1 40 

000140/ 047000 000000 .0 47000 1 



000 140/ 047000 000001 
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SAVE (SA) 



Function 



The SAVE command writes out a core image of the user's core area on the specified 
device. It saves any user program (reentrant, one segment nonreentrant, or two 
segment nonreentrant) as one or two files. Later, when the program is loaded by 
a GET, R, or RUN command, it will be nonreentrant. If DDT was loaded with the 
program, the entire core area is written; if not, the area starting from zero up 
through the program break (as specified by JOBFF) is written. 



Command Format 



SAVE devrfile.ext core 

dev: = the device on which the core image file is to be written . The default 
device name is DSK: The colon following the device name is required. 

file.ext = the name to be assigned to the core image file. The default 
filename is the job's current name as set by the last R, RUN, GET, SAVE, 
or SSAVE command, or the last SETNAM UUO. Ext applies to the low file, 
not the high file. An extension of .SHR, then .HGH, is assumed for the 
high file. If the user types an extension of .SHR or .HGH, the extension 
is treated as a null extension since .SHR and .HGH are confusing as low 
file extensions. If ext is omitted and the program has only one segment, 
the ext is assumed to be .SAV. If ext is omitted and the program has two 
segments, the high segment will have extension .HGH, and the low segment 
will have extension .LOW. 

core = the amount of core in which the program is to be run. This value is 
stored in JOBDAT as the job's core area (JOBCOR) and is used by the RUN 
and GET commands. Specified as number of IK blocks. This argument is 
optional . 

If core is omitted, only the number of blocks required by the core image 
area (as explained previously) is assumed. 



Characteristics 



The SAVE command: 

leaves the console in monitor mode, 
requires core, 

does not allow an active device, 
requires a job number and LOGIN. 



Revision 1 Monitors 



2-73 January 1971 



Associated Messages 

?nK CORE NEEDED 

The user's current core allocation is less than the contents of JOBFF. 
?DEVICE dev NOT AVAILABLE 

Device dev: is assigned to another user. 

^TRANSMISSION ERROR 

An error was detected while reading or writing the core image file. 
? ENTER FAILURE n 

The ENTER to write the file failed; n is the disk error code 
(see Appendix E) . 

JOB SAVED 

The output is completed. 

?NO SUCH DEVICE 

The device does not exist in this configuration. 



Example 



^SAVE DSK:TEST^ 
JOB SAVED 



SSAVE (SSA) 



Function 



The SSAVE command is the same as the SAVE command except that the high segment, 
if present, will be sharable when it is loaded with the GET command. To indicate 
this sharability, the high segment is written with extension .SHR instead of .HGH. 
A subsequent GET will cause the high segment to be sharable. Because an error 
message is not given if the program does not have a high segment, a user can use 
this command to save CUSPs without having to know which are sharable. 
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Command Format' 



SSAVE dev:file.ext core 

Arguments are the same as in the SAVE command. 



Characteristics 



The SSAVE command: 



leaves the console in monitor mode, 
requires core, 

does not allow an active device, 
requires a job number and LOGIN. 



Associated Messages 



?nK CORE NEEDED 

The user's current core allocation is less than the contents of JOBFF. 

?DEVICE dev NOT AVAILABLE 

Device dev: is assigned to another user. 

?TRANSMISSION ERROR 

An error was detected while reading or writing the core image file. 
9ENTER FAILURE n 

The ENTER to write the file failed; n is the disk error code 
(see Appendix E). 

JOB SAVED 

The output is completed. 

?NO SUCH DEVICE 

The device does not exist in this configuration. 



Example 



.SSAVE DSK:TESTjk 
JOB SAVED 



.LOAD FILEI^) 
WCRO: FILE1 
LOADING 

LOADER IK CORE 
EXIT 

^SSAVEj 
JOB SAVED 

JOB SETUP 
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2.8.1 Additional Information on SAVE and SSAVE 

Before writing SAVed or LOW files in response to SAVE and SSAVE commands, the monitor compresses 
the user's core image by eliminating consecutive blocks of zeroes. This technique is known as zero- 
compression and is used to save space on file media. Low segment files are zero-compressed on devices 
DTA, MTA, and DSK, but high segment files are not because the high segment may be shared at the 
time of the command . 

Saved files are ordinary binary files and can be copied using the /& switch in PIP. Files with the LOW 
or SAV extension may be read in dump mode, but must be reexpanded before being run. The monitor 
expands the file after input on a RUN, R, or GET command. 

The data format of a zero-compressed saved file consists of a series of IOWDs and data block pairs and 
is terminated by a JRST A where A is the contents of JOBSA. The format is as follows: 



XWD -nl, odrt-1 



XWD -n2. gdr 2-1 



}• 
}■ 



1 WORDS 



2 WORDS 



XWD 


-nN, 


adr 


N-1 




JRST 


A 







} 



nN WORDS 



Each IOWD describes the length of the following data block and the original location of the data in 
core. 

Saved files are read into the user's core area starting at location JOBSAV and then are expanded to 
occupy the original relative locations. If the first word read is not an IOWD and is positive, an old- 
format, non-compressed saved file is assumed and no expansion is performed. 

A SAVE command issued to a magnetic tape writes 

a. a high segment (possibly null) 

b. an EOF 

c . a low segment 

a. an tUr. (continued on next page) 
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QDCEIll^QEICEDC^IIDIlI] 



HIGH SEGMENT 



LOW SEGMENT 



or [Zl CE] Q CED [ID EsD 



NULL HIGH SEGMENT 



LOW SEGMENT 



R6 EOF 



10-0540 
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The monitor does not determine the file size of a low segment on a GET from magnetic tape; therefore, 
a user must always specify a core argument or have enough core assigned to his job for the file. 

To save file space, only the high segment up through the highest location (relative to high segment 
origin) loaded, as specified in the LH of JOBHRL, will be written by the SAVE command. If LH is 
zero (high segment created by CORE or REMAP UUO) or DDT is present, the entire high segment will 
be written . 

Most programs are written so that only the high segment contains non-zero data. This also saves file 
space and I/O time with the GET command. SAVE writes the high segment (.HGH) only. The LOADER 
indicates to the SAVE command that no data was loaded above the job data area in the low segment by 
setting the LH of JOBCOR to the highest location loaded in the low segment with non-zero data. 



A number of locations in the fob data area need to be initialized on a GET, although there is no other 

data in the low segment. The SAVE command copies these locations into the first 10 locations of the 

8 
high segment, provided it is not sharable. The 10 locations are referred to as the vestigial job data 

area (refer to Paragraph 3.2.2.3). Therefore, the LOADER will load high segment programs starting at 

location 400010. 

To prevent user confusion, SAVE and SSAVE delete a previous file with the extension .SHR or .HGH; 
therefore, SAVE deletes a file with the extension .SHR and SSAVE deletes a file with the extension 
.HGH. SAVE and SSAVE commands also delete files with the extension .LOW, if the high segment 
was the only segment written. 

The regular access rights of the saved file indicate whether a user can perform a GET, R, or RUN com- 
mand. These commands assume that the user wants to execute (but not modify) the high segment, inde- 
pendent of the access rights of the file used to initialize the segment. The monitor always enables the 
hardware user-mode write protect to prevent the user program from storing into the segment inadvertent- 

ly- 

To debug a reentrant CUSP in the system directory, the user should make a private, nonsharable copy, 
rather than modify the shared version and possibly cause harm to other users. To make a private, non- 
sharable copy, the following commands are used: 

a. GET SYS:cusp 

b. SAVE dev:cusp Writes a file in the user directory as nonsharable. The high 

segment in the user's addressing space remains sharable. 

c. GET dev:cusp Overlays the sharable program with the nonsharable one from 

the user's directory. Now the user can make patches while 
other users share the version in the system directory. 
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A SAVE of a one-segment program and a SSAVE of a two-segment program of the same name can 
coexist in the same directory, and the monitor keeps the two versions separate. This allows for a 
common library of reentrant and non-reentrant versions of the same CUSPs to service both the PDP-6 
and PDP-10. A sharable program may be superseded into the directory by the SSAVE command. The 
monitor clears the high segment in its table of storable segments in use but does not remove the seg- 
ment from the addressing space of users currently using it. Only the users doing a GET, R, or RUN 
command or a RUN or GETSEG UUO have the new sharable version. 

When the SAVE or SSAVE command is used to save a sharable program with only a high file, the 
monitor does not modify the vestigial job data area unless the user has write privileges to the file that 
initialized the shared segment. This prohibits unauthorized users from modifying the first 10 locations 
of a shared segment. This restriction does not exist if a low file is also written, because the GET 
command reads the low file after the high file. The real job data area locations are set from the low 
file. 

2.9 DETACHED JOB CONTROL COMMANDS 

A job is detached if it is not under control of a user console. Any console can initiate any number of 
detached jobs. Output to the console from a job running in a detached mode causes the job to stop. 
When the console is attached to the job, the job is continued and the output is done. 



PJOB (PJ) 



Function 



The PJOB command causes the monitor to respond with the job number to which the 
user's console is attached. 



Command Format 
PJOB 
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Characteristics 



The PJOB command: 



leaves the console in monitor mode, 
requires a job number and LOGIN. 



Associated Messages 



None 



Example 



..PJOB J 



CSTART (CS) 
CCO NT (CC) 



Function 



The CSTART and CCONT commands are identical to the START and CONT commands, 
respectively, except that the console is left in the monitor mode. 



Command Format 



CSTART 
CCONT 



To use: 



1 . Begin the program with the console in user mode. 

2. Type control information to the program, then type tC to 
halt the job with console in monitor mode. 

3. Type CCONT to allow job to continue running and leave 
console in monitor mode. 

4. Additional monitor commands can now be entered from the 
console. 
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Characteristics 



The CSTART and CCONT commands: 

leave the console in monitor mode, 

require core, 

require a job number and LOGIN. 



Restrictions 



These commands should not be used when the user program (which is continuing to run) 
is also requesting input from the console. 

Associated Messages 

?NO CORE ASSIGNED 

No core was allocated to the user when the GET command was given, 
and no core argument was specified in the GET. 

?NO START ADR 

Starting address was because user failed to specify a starting address in 
the END statement of the source program. 

?CAN'T CONTINUE 

The job was halted due to a monitor-detected error and cannot be 
continued. 

7PLEASETYPE tC FIRST 

A command which would start a job is issued after a CSTART or CCONT. 

Example 

^CSTART ) 



DETACH (DET) 



Function 



The DETACH command disconnects the console from the user's job without affecting 
the status of the job. The user console is now free to control another job, either 
by initiating a new job or attaching to a currently running detached job. 
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Command Format 
DETACH 

Characteristics 



The DETACH command: 

detaches the console, 
requires LOGIN. 



Associated Messages 



FROM JOB n 



Example 



This is an informative message telling the user the job number to which the 
console was attached. 



_.DETACH J 
FROM JOB 1 



ATTACH (AT) 



Function 



The ATTACH command detaches the current job, if any, and connects the console 
to a detached job. 



Command Format 



ATTACH job [proj,prog] 

job = the job number of the job to which the console is to be attached. 
This argument is required. 

[proj,prog] = the project-programmer number of the originator of the 
desired job. This argument may be omitted if it is the same as the job 
to which the console is currently attached. The operator (device OPR) 
may always attach to a job although another console is attached, pro- 
vided he specifies the proper [proj,prog] . 
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Characteristics 



The ATTACH command: 

leaves the console in monitor mode. 



Associated Messages 



If an error message occurs, the console remains attached to its current job. 

TTTYn ALREADY An ACHED 

The job number typed is erroneous and is attached to another console, 
or another user is attached to the job. 

?ILLEGAL JOB NUMBER 

The specified job number is impossible. 

?NOT A JOB 

The job number is not assigned to any currently running job. 

?CANT ATT TO JOB 

The project-programmer number entered is not that of the originator 
of the desired job. 

FROM JOB n 

An informative message telling the user the job number, if any, from 
which the console is detaching. 



Example 



^_ATT 1 C 10*63 3 ) 
FRON' JOB 5 



2.10 JOB TERMINATION COMMANDS 

When a user leaves the system, all facilities allocated to his jobs must be returned to the monitor 
facility pool so that they are available to others. 
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KJOB (K) 



Function 



In multiprogramming systems, the KJOB command: 

Stops all assigned I/O devices and returns them to the monitor pool. 

Returns all allocated core to the monitor pool. 

Returns the job number to the pool . 

Leaves the console in the monitor mode. 

Performs an automatic TIME command. 

In swapping systems, the KJOB command performs all the above procedures. In 
addition, if the user has accessed any files, the command responds with 

CONFIRM: 

The user may type tC to abort logout, or type an optional file structure name (or list 
of file structure names) preceded by one of the following: 

F J to logout immediately saving all files (including temporary files) 
as they are. 

D J to delete all files on the specified file structures. Responds with 
ARE YOU SURE? TYPE Y OR CR. 

K ) to delete all unpreserved (unprotected) files on the specified file 
structures. 

P J to save and preserve all but temporary files (TMP, CRF, LST) on 
the specified file structures. 

S J to save without preserving all but temporary files on the specified 
file structures. 

L J to list the directories of the specified file structures. 

I J to individually determine what to do with all files on the specified 
file structure as follows: 

After each filename is listed, type 

P J to preserve the file. 

S J to save the file. 

K ^ to delete the file. 

QJ to learn if over logged-out quota on this file structure. 

If not over quota, nothing is typed, and the same filename 
is repeated. 
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E^ to skip to next file structure and save this file if below 
logged-out quota for this file structure. If not below 
logged-out quota, a message is typed and the same file- 
name is repeated. 

IjJ to list responses and meanings. 

Uj to individually determine what to do with all but preserved 
files. Preserved files are always preserved. 

BJ to delete no files except when user is over quota, then 

delete enough files to be below quota. 

Q^ to learn if over logged-out quota on the specified file 
structures . 

HV to list the K JOB options and their meanings. 

If no file structure names are specified, the responses are for all file structure 
names in the job search list. If file structure names are specified, the responses 
apply to those file structures, and CONFIRM is retyped. The KJOB command 
ignores all logical assignments. 



Command Formats 



1) KJOB 

CONFIRM: 

When the CONFIRM: response is given, the user may type any of the above- 
described letters followed by an optional file structure name or list of file 
structure names separated by commas. 

2) KJOB <file descriptor> *- or =/<letter><list of file structure names >/<letter> 
<list names >etc. 

<file descriptor >= <dev:file.ext [ppn]> 

/<lerter > = any letter of the above-described letters. In addition, the /Z 
option is available to Batch jobs. /Z does not perform queuing operations 
which the Batch user asked to be deferred until LOGOUT time. The letters 
must appear after the -or =. If no file descriptor is specified, the default 
is TTY. 



Characteristics 



The KJOB command: 



detaches the console, 

does not allow an active device, 

runs the KJOB and LOGOUT CUSPs. 
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Associated Messages 

NO SUCH STR 

A nonexistent file structure was specified. 

fs LOGGED OUT QUOTA n EXCEEDED BY m BLOCKS 

The user's allocation on the file structure named is greater than his logged- 
out quota . 

WAIT PLS 

The accounting file FACT. SYS was busy for ten seconds. LOGOUT retries 
for ten more seconds before going on to FACT.X01 . 

?<file structure name >UFD READ ERROR, STATUS = n 

A read error occurred while reading the user's UFD on the file structure. 
Status n tells which error occurred. 

?SYSSTR FAILURE 

SYSSTR UUO gave an error return. Notify the operator. 

?STRUUO FAILURE 

STRUUO UUO gave an error return. Notify the operator. 

ACCOUNTING SYSTEM FAILURE . . . 
Notify the operator. 

?DSKCHR FAILURE ON UNIT u 

DSKCHR UUO gave an unexpected error return. Notify the operator. 

JOB n USER [p,p] LOGGED OFF TTY n AT hhmm dd-mm-yy 
DELETED <ALL>n FILES 

SAVED <ALL >n FILES m TOTAL BLOCKS USED 
ANOTHER JOB STILL LOGGED IN UNDER [p,p] 
RUNTIME n MIN m SEC 

This information is typed as user logs off successful ly . 

Note that m is total blocks allocated as opposed to blocks written . 

Therefore, it is always greater than or equal to the number of blocks 

written. 

TYPE H FOR HELP 

An unintelligible response or command has been typed. Either the 
filename or the CONFIRM: message is repeated, depending on what 
was typed. 
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Example 



CONFIRM: I 
DSKB: 
TFST4 .TST 


<055> 


2000. BLKS 


: KJ 




TEST 5 


• TST 


<055> 


505. BLKS 


: V) 




Tl 1 


.BAK 


<055> 


5. BLKS : 


: s) 

TTY24 AT 2309 




T2 


.BAK 


<055> 


5. BLKS : 




T3 


.BAK 


<055> 


5. BLKS : 




TEST 


-RAK 


<0 5 5> 


5. BLKS : 




TEST 


• HEL 


<055> 


5. BLKS : 




TEST 


. MAC 


<055> 


5. BLKS : 




TEST 


.SHR 


<055> 


30. BLKS 




JOB 5 


. USE 

:d 5 


R til/) ,43 3 LOGGED OKK 


1 1 -SEP-70 


DELETf 


FILES 


,5 TOTAL BLOCKS USED 




SAVED 


A FILES 25< 




RUNTIME 


V--IK, 00 


.60 SEC 







2.11 SYSTEM TIMING AND USAGE COMMANDS 

All system times are kept in increments of one-sixtieth or one-fiftieth of a second, depending on the 

line frequency of the power connected to the PDP-10. 



DAYTIME (DA) 



Function 



The DAYTIME command types the date followed by the time of day. The date and 
time are typed in the following format: 

dd-mmm-yy hh:mm:ss.hh 



where 



dd = day 

mmm = month 

yy = year 

hh = hours 

mm = minutes 

ss.hh = seconds to nearest hundredth. 



Command Format 



DAYTIME 



Characteristics 



The DAYTIME command: 

leaves the console in monitor mode. 
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Associated Messages 
None 



Example 



^DAY J 

ll-SEP-70 22:36:34 



SCHED 



Function 



The SCHED command types out the schedule bits as set by the last 
SET SCHED command. 



Command Format 



SCHED 
Characteristics 



The SCHED command: 

leaves the console in monitor mode. 



Associated M essag es 
None 

Example 



.SCHED 
000000 
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TIME (TI) 



Function 



The TIME command causes typeout of the total running time since the last TIME 
command, followed by the total running time used by the job since it was initialized 
(logged in), followed by the integrated product of running time and core size 
(KILO-CORE-SEC=). Time is typed in the following format: 

hh:mm:ss.hh 

where 

hh = hours 

mm = minutes 

ss.hh = seconds to nearest hundredth. 

Interrupt level and job scheduling times are charged to the user who was running when 
the interrupt or rescheduling occurred. 

NOTE 

If automatic runtime is enabled using the WATCH com- 
mand, the incremental runtime is usually 0. 



Command Format 



TIME job 



job = the fob number of the job whose timing is desired. If job is omitted, 
the job to which the console is attached is assumed. In this case, monitor 
types out the incremental running time (running time since last TIME com- 
mand) as well as the total running time since the job was initialized. 



Characteristics 



The TIME command: 

leaves the console in monitor mode. 



Associated Messages 



7ILLEGAL JOB NUMBER 

The job number specified is impossible. 



Revision 1 Monitors 2-88 January 1971 



Example 



/TIME J 

6.38 

6.38 

KILO-CORE-SEC =26 



R QUOLST 



Function 



The R QUOLST command runs the QUOLST CUSP and types the reserved, logged-in 
and logged-out quotas followed by the number of free blocks left for each file 
structure in the job search list (refer to Paragraph 6.2.7). In addition, the names 
of all the file structures in the system are typed followed by the number of free blocks 
in each file structure that are available to all users. 



Command Format 
R QUOLST 

Characteristics 



The R QUOLST command: 

leaves the console in monitor mode, 

runs the QUOLST CUSP, 

requires a job number and LOGIN. 



Associated Messages 



None 
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Example 



•R QUOLST ) 

YOUR STRUCTURES : 

DSKB: RSRVD = FCFS 



= 20000 QUOTA OUT 



5000 FREE = 17580 



SYSTEM STRUCTURES: 



DSKA: FREE = 831 



DSKB: FREE = 16525 



EXIT 



SET WATCH 



Function 



The SET WATCH command sets the system to print incremental job statistics automatically. 



Command Formats 



1) SET WATCH arg.., arg_,...,arg g 

prints the specified WATCH statistics. 

2) SET WATCH ALL 

prints all the WATCH statistics. 

3) SET WATCH NONE 

eliminates the printing of all WATCH statistics. 

4) SET WATCH NO arg „ arg-,..., arg_ 

eliminates the printing of the specified WATCH 
statistics. 



(continued on next page) 
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The following argument enables printing whenever a monitor command 
switches the console from monitor mode to user mode. 

arg = DAY prints the time of day, as [HH:MM.SS] 

The following arguments enable printing whenever the console is returned 
to monitor mode via tC, EXIT, HALT, ERROR IN JOB n, DEVICE xxx OK ? 

arg = RUN prints the incremental run time. 

arg = WAIT prints the wait time (time since the user started or continued 
the program). 

arg = READ prints the incremental number of disk blocks read modulo 
4096. 

arg = WRITE prints the incremental number of disk blocks written 
modulo 4096. 

Any combination of the arguments may be specified in any order. 
Statistics are not printed for commands that do not run programs, such 
as ASSIGN or PJOB. When a user logs in, his job is set to WATCH 
the statistics that he has notified the system manager of. These statistics 
are kept in ACCT.SYS. 

The order of the error message is the same as the order of output . There- 
fore, a user who forgets either the arguments or the significance of the 
statistics can find these out. A single space is always typed between 
each statistic, whether the statistic appears or not; therefore, it is 
possible to tell which statistics are being typed. 

NOTE 

Enabling WATCH output interacts with the incremental 
data typed by the TIME and DSK commands. 



Characteristics 

I The SET WATCH command: 

leaves the console in monitor mode. 

Associated Messages 

?ARGS ARE: DAY, RUN, WAIT, READ, WRITE 
The user typed an illegal argument. 



Exampl e 

I 



.SET WATCH DAY RUN WAIT READ WRITE 



• tC 



^R PIP J 

C22;38:I93 

*tC 

C0.10 2.95 457 2433 
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•R PIP,) 

C22;38:373 

*LPT : -SYS :PAR 10 .SCP 

[0.17 gg.43 6 3 

.SET WATCH Hj 

?ARGS ARE: DAY, RUNjWAITjKEAD, WRITE 



SYSTAT (SYS) 



Function 

The SYSTAT command runs a CUSP which prints status information about the system. 
This information allows a user to determine the load on the system before logging-in. 

To write the output on the disk as a file with name SYSTAT.TXT, assign device DSK 
with logical name SYSTAT. 

The SYSTAT command types the status of the system: system name, time of day, date, 
uptime, percent null time (idle plus lost time). 

It types status of each job logged-in: job number (@ after job number indicates the 
high segment has been superseded; * after the job number indicates the high segment 
is from a directory or device other than the CUSP directory on device SYS; ! after 
the job number indicates the job is locked in core but is shufflable; & after the 
job number indicates the job is locked in core and not shufflable); project-programmer 
number (**,** if detached); Teletype number (CTY = console Teletype, DET = de- 
tached); program name being run; program size; job and swapped state (refer to 
Paragraph 4.9.3.3); and run time since logged in. 

It types the status of high segments being used: name (PRIV = nonsharable, OB5 = 
superseded); device or file structure name from which the segment came; directory 
name (**,** if detached); size (SW = swapped out, SWF = swapped out and frag- 
mented, F = in core and fragmented on disk, SPY = user is executing the SPY UUO); 
number of users in core or on the disk . 

It types the status of dormant segments: name, device name, directory name, size 
(SW - swapped out, SWF = swapped out and fragmented, F = in core and fragmented 
on disk) . 

The command types swapping space used, virtual core used, swapping ratio, virtual 
core saved by sharing . 

It types status of busy devices: device name, job number, how device is assigned 
(AS = ASSIGN command, INIT = INIT or OPEN UUO, AS+INIT - both ways). 

It types system file structures: free blocks, mount count, single-access job. It types 
disk performance, swapping, and error statistics: free blocks for each file structure 
followed by the following items, in columns, for each unit: number of free blocks 
(FREE), number of buffered-mode blocks read (BR) and written (BW), number of 
dump-mode blocks read (DR) and written (DW), number of blocks read (MR) and 
written (MW) for monitor I/O (UFD, RIB, MFD), and number of seeks for any \/0. 

It types the status bits for each unit as follows: RHB, monitor must reread HOME 
block; OFL, unit is off-line; HWP, unit is hardware write-protected; SWP, unit is 
software write-protected for this job; SAF, unit is member of single-access file 
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structure; ZMT, unit is member of a file structure with zero mount count; PRF, unused 
by monitor; PNM, pack not mounted on this unit; DWN, unit is down; MSB, unit 
has more than 1 SAT block; NNA, no new accesses have been specified by operator. 

It types the following error information: HDEV (number of hard device, channel 
and controller, errors on this unit); HDAT (number of hard data, parity, errors on 
this unit); SDEV (number of soft and hard device, channel and controller, errors on 
this unit); SDAT (number of soft and hard data errors, parity, on this unit); HPOS 
(number of hard positioning failures, recalibrating did not correct, for this unit); 
SPOS (number of soft positioning failures, recalibrating once corrected, for this 
unit); SER (number of SAT failures); RER (number of rib redundance failures); CER 
(number of software folded checksum failures); HERR STATUS (last device status 
on hard device or data errors, in octal); SERR STATUS Oast device status on a soft 
device or data error, in octal); LBN (last logical block number in octal of region 
which had the latest hard data error). 

It types the following data for each unit in the active swapping list: physical unit 
name, number of blocks (128 word) swapped in (R) and out (W), ratio and percent 
of number of K used and al located for swapping . 



Command Format 



SYSTAT arg 

arg = one or more single letters (in any order) used to type any subset of 
the SYSTAT output. This argument is optional . The letters are as follows: 

B = busy devices 

D = dormant segments 

F = file structures 

H = options available 

J = job information 

N — al I but job information 

S = job information without state and run time 

L = output on device LPT. If LPT is unavailable, the 

message LPT BUSY - WAITING is typed, and every 

5 seconds the LPT is tried again . 
P = disk performance 



Characteristics 



The SYSTAT command: 

leaves the console in monitor mode, 
runs the SYSTAT CUSP, 
does not require LOGIN. 



Associated Messages 
None 
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Example 



.SYSTATJ 

STATUS OF 51236A SYS#2 AT 1S:*5:44 ON 1 7- DEC- 7i 

UPTIME 4§:35, 647. NULL TIME = 23% IDLE + 41Z LOST 

SHUFFLE TIME = 3§.42, CORE ZEROING TIME = 2.15 

22 J03S IN USE OUT OF 37. 2i LOGGED IN, 22 DETACHED 



JOB 

1 

2 

3 

4 

5 

5 

7 

8 

9 

II 

11 

12 

13 

14 

15 

16 

18 

19 

2J 

21 

22 

23 



WHO 


WHERE 


WHAT 


SIZE 


STATE 


RUN TIME 


^P^h A ^P^P 


DET 


PRINT 


IK 


TI 


SW 


1:29 


**, '** 


DET 


OPSER 


1+2K 


SL 


SW 


3 


^P*^ A ^^^^ 


DET 


PIP 


1+4K 


tc 


SW 


43 


**,** 


DET 


BATCON 


6K 


SL 


SW 


15 


**,** 


DET 


TECO 


3+3 K 


TI 


SW 


33 


**,** 


DET 


OMOUNT 


9K 


SL 


SW 


4 


**,** 


DET 


SYSTAT 


3K 


RN 




i 


**,** 


DET 


OMOUNT 


9K 


TI 


SW 


1 


^p^n a ^^ ^^ 


DET 


LOGIN 


1+2K 


RN 




3 


**,** 


DET 


SYSDPY 


3+SPY 


TI 




4:41 


**,** 


DET 


PRINTR 


2K 


10 




7 


**,** 


DET 


D3ASIC 


2§+7K 


RN 


SW 


l:2i 


**,** 


DET 


DIRECT 


1+2* 


TC 


SW 


1 


**,** 


DET 


LPTSPL 


2K 


SL 


SW 


4 


**,** 


DET 


CDRSTK 


4K 


TC 


SW 


9 


**,** 


DET 


PIP 


1+4K 


TC 


SW 


2 


^r^^ * ^F^^ 


DET 


KJOB 


4+2 K 


TI 


SW 


8 


**,#* 


DET 


PIP 


1+4K 


TI 


SW 


1:12 


**,** 


DET 


DIRECT 


1+2K 


TC 


SW 


1 


**,*# 


DET 


KJOB 


4+2 K 


TI 


SW 


4 


**,** 


DET 


FAI31G 


9K 


TC 


SW 


1:18 


**,** 


DET 


MACRO 


4+SK 


RN 


SW 


38 



HIGH SEGMENTS: 
PROGRAM DEVICE 



OWNER 



HIGH K USERS 



OPSER 

LOGIN 

PIP 

DIRECT 

(PRIV) 

TECO 

MACRO 

KJ03 



DSKB 
DSKB 
DSKB 

DSKB 

DSKB 
DSKB 
DSKB 



SYS 

SYS 

SYS 

SYS 

JOB 12 

SYS 

SYS 

SYS 



2K SW 
2K 

4K SW 
2K SW 
7K SW 
3K SW 
6K SW 
2K SW 



1 
1 
3 
2 
1 
1 
1 
2 



DORMANT SEGMENTS: 

PROGRAM DEVICE OWNER HIGH K 





^MANGR 


DSKB 


SYS 


IK SW 




TECO 


DSKB 


12,141 


3K SW 




COMPIL 


DSKB 


SYS 


2K SW 




LPTSPL 


DSK3 


SYS 


2K SW 




LPTSPL 


DSKB 


1,2 


2K SW 




CDRSTK 


DSKB 


SYS 


2K SW 




LOADER 


DSKB 


SYS 


3K SW 




3INC0M 


DSKB 


11,131 


1 K SW 




FED 


DSKB 


SYS 


4K SW 




F4J 


DSKB 


SYS 


18K SW 




SRCCOM 


DSKB 


SYS 


1 K SW 




RUNOFF 


DSKB 


SYS 


2K SW 




LOGOUT 


DSKB 


SYS 


2K SW 
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SWAPPING SPACE USED = 144/375 = 38Z 
VlfiT. CORE USED = 118/375 = 31Z 
SWAPPING RATIO = 118/27 = 4.4 
VIST. CORE SAVED BY SHARING z 12/(12+118) 



= 9% 



BUSY Di 


IVICES: 




DEVICE 


J03 


WHY 


PTY5 


2 


INIT 


PTY1 


2 


INIT 


PTY3 


2 


INIT 


PTY4 


O 


INIT 


PTYv 


2 


INIT 


PTYS 


2 


INIT 


PTY18 


2 


INIT 


DTA1 


19 


AS 


DTA2 


22 


AS 


DTA3 


23 


AS 


DTAS 


1 


AS 


DTA7 


6 


AS 


,1TA^ 


9 


AS+INIT 


SYSTEM 


FILE STRUCTURES: 


NAME 


FREE 


MOUNT 


DSKA 


4631 


9 


DSK3 


12269 


19 



DISK PERFORMANCE STATISTICS: 
UNIT OR F/S 

FREE 3R 3W 

DSKA 4628 

FHAJ(GLZX): 

1447 518 3 

FHAKGLZX2): 

3181 121 1 

DSK3 12269 

DPA»C2RP3J1): 

6114 2545 929 

DPM(2RPW5) : . CE ' R:13 HERR STATUS ^ SERR^STATUS: 4*115 

6125 24 ^3 1474 1868 2f2 1116 
MSB tRRORS: SDAT:2 HERR STATUS: 15 SERR STATUS:5« J4il5 

ACTIVE SWAPPING STATISTICS: 
UNIT R W USED(K) 
FHAi 274656 194616 14»/3fil = 47Z 
DP A* J 4 S/75 = i% 



DR 

317 
328 

63 i 



DW 

i 
16 

219 



MR 

331 
543 

5155 



MW 

69 
111 

1256 

547 



SEEKS 

f 

§ 

3634 
2346 
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DSK (DS) 



Function 



The DSK command types disk usage for the combined structures of the job, since the 
last DSK command, followed by the total disk usage since the job was initialized 
(logged in). Disk usage is typed in the following format: 

RD,WT=I,J 
RD,WT=M,N 

where I and J are the incremental number of 128-word blocks read and written since 
the last DSK command, and M and N are the total number of 128-word blocks read 
and written since LOGIN. 

NOTE 

I and J are kept modulo 4096. If automatic READ or 
WRITE print outs have been enabled using the WATCH 
command, I and J are usually zero, since the WATCH 
output also resets these values. 



Command Format 



DSK job 

job = the Job number of the job for which the disk usage is desired. This 
argument is optional. 

If job is omitted, the Job to which the console is attached is assumed. 

If job is supplied (whether the job of this user or another user) the 
incremental quantities are not reset to zero. 



Characteristics 



The DSK command: 



leaves the console in monitor mode, 
requires a job number and LOGIN. 



Associated Messages 



?NOT A JOB NUMBER 

The job number specified is not assigned to any currently running job. 



Example 



.DSK J 

RD,WT=12,0 

RD,WT=475,243 



2.12 TELETYPE CHARACTERISTICS COMMAND 

I The SET TTY command accepts text arguments and modifies the monitor table of characteristics for a 
Teletype line. This command also allows a Teletype to be assigned by a job which is not controlling 
it. 
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SETTTY 



Function 
I The SET TTY command declares special properties of the Teletype line to the scanner service. 

Command Format 
| SETTTYdev: NO word 

dev: = the device argument that is used to control a line other than the one 
where the command is typed . This argument is optional and is legal only 
from the operator's console. It may be used to modify the characteristics 
of any Teletype lines in the system. 

NO = the argument that determines whether a bit is to be set or cleared. 
This argument is optional . 

word = the various words representing bits that may be modified by this 
command. The words are as follows: 



SET TTY TAB 



SET TTY NO TAB 



SET TTY FORM 



SET TTY NO FORM 



SET TTY LC 



SET TTY NO LC 



SET TTY WIDTH n 



SET TTY NO CRLF 



SET TTY CRLF 



This terminal has hardware TAB stops set 
every eight columns. 

The monitor simulates TAB output from 
programs by sending the necessary number 
of SPAC E characters . 

This terminal has hardware FORM (PAGE) 
and VT (vertical tab) characters. 

The monitor sends eight linefeeds for a FORM 
and four linefeeds for a VT. 

The translation of lower-case characters input 
to upper case is suppressed . 

The monitor translates lower-case characters 
to upper case as they are received. In either 
case, the echo sent back matches the case of 
the characters being sent. 

The carriage width (the point at which a free 
carriage return is inserted) is set to n . The 
range of n is 17 (two TAB stops) to 200 decimal . 

The carriage return normally outputted at the 
end of a line exceeding the carriage width is 
suppressed . 

Restores the carriage return . 

(continued on next page) 
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SET TTY SLAVE 

SET TTY NO ECHO 
SET TTY ECHO 
SET TTY FILL n 

SET TTY NO FILL 



The Teletype becomes slaved, i.e., no commands 
may be typed on the console, and the console may 
be ASSIGNed by another user. 

The Teletype line has local copy and the computer 
should not echo characters typed in. 

Restores the normal echoing of each character typed 
in. 

The filler class n is assigned to this terminal. The 
filler character is always DEL (RUBOUT, 377 octal). 
No fillers are supplied for image mode output. 

Equivalent to TTY FILL 0. Fillers for output and 
echoing are determined from the following: 



Character 

Name 


Octal 


Number of Fillers for Filler 


Class 





1 


2 


3 


BS 


010 





2 


6 


6 t 
1 or2 T 


HT 


on 





1 or 2 


1 or 2 


LF 


012 





1 


6 


6 


VT 


013 





2 


6 


6 


FF 


014 





12 


21 


21 


XON 


021 





1 


1 


1 


TAPE 


022 





1 


1 


1 


XOFF 


023 





1 


1 


1 


NTAP 


024 





1 


1 


1 



Characteristics 



The SET TTY command: 

leaves the console in monitor mode. 



Associated Messages 



None 



2.13 SYSTEM ADMINISTRATION COMMANDS 

The commands in this section are restricted to system administrators only. 



1 if 0-3 spaces to TAB stop, 2 if 4-7 spaces to TAB stop. 



Revision 1 Monitors 



2-98 



January 1971 



SET DAYTIME 



Function 



| The SET DAYTIME command when used with an argument changes the time of day. 



Command format 



SET DAYTIME n 



n - decimal number through 2359, representing 24-hour time 
(i.e., hours * 100 + minutes) . This argument is required. 

Characteristics 

| The SET DAYTIME command: 

leaves the console in monitor mode. 

Restrictions 
| The user must be on device OPR or be logged in under [1,2]. 

Associated Messages 
None 



SET SCHEDULE 



Function 



| The SET SCHEDULE command changes the scheduled use of the system, depending 



on n. 
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Command format 

I SET SCHEDULE n 

n is octal and is stored in RH of STATES word in COMMON. 

n = regular timesharing 

n = 1 no further LOGINS allowed except from CTY, 

n = 2 no further LOGINS from remote Teletype's, 

and do not answer data sets . 

Characteristics 

| The SET SCHEDULE command: 

leaves the console in monitor mode. 

Restrictions 
I The user must be on device OPR or be logged in under [ 1 ,2] . 

Associated Messages 
None 



ASSIGN SYS: 



Function 

The ASSIGN SYS command changes the systems device to device dev. 

Command Format 

ASSIGN SYS:dev 

dev = the device to which the system device is changed. 

Characteristics 

The ASSIGN SYS command: 

leaves the console in monitor mode, 
requires a job number and LOGIN. 
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Restrictions 
1 The user must be on device OPR or logged in under [1,2] 

Associated Messqges 
None 



DETACH (DET) 



Functi 



The DETACH command assigns the device dev to JOB 0, thus making it unavailable. 

Command Format 

DETACH dev 

dev = the name of the device to be detached. 

Characteristics 

The DETACH command: 

leaves the console in monitor mode, 
requires a job number and LOGIN. 

Restrictions 
| The user must be on device OPR or be logged in under [ 1 ,2] . DSK cannot be detached. 

Associated Messages 

?ALREADY ASSIGNED TO JOB n 

The device specified is already in use. 

I?CAN'T DET DEV 
The user is not logged-in under [1,2]. 

?NO SUCH DEVICE 

The specified device does not exist in this monitor configuration. 
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ATTACH (AT) 



Function 



The ATTACH command returns a detached device to the user issuing the command, and 
then the user must DEASSIGN the device to return it to the monitor's pool of available 
resources. 



Command Format 



ATTACH dev 

dev = the device to which the user is attaching. 



Characteristics 



The ATTACH command: 

leaves the console in monitor mode, 
requires a job number and LOGIN. 

Restrictions 
I The user must be on device OPR or be logged in under [1 ,2] . 

Associated Messages 

9CAN'T AH DEV 
I The user is not logged-in under [1 ,2] . 

?NO SUCH DEVICE 

The specified device does not exist in this monitor configuration. 

?WASN'TDET 

The specified device is not detached. 
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CTEST 



Function 



The CTEST command is used by system programmers to pass arguments to test extensions 
made to the COMPIL CUSP. 



Command Format 
CTEST 

Characteristics 



The CTEST command: 



runs the COMPIL CUSP, 
requires LOGIN. 



Associated Messages 
None 



SET DATE 



Function 

The SET DATE command is used to change the date. 

Command Format 

SET DATE mm dd yy 

mm = two-character number of month . 
dd = two-digit day of month, 
yy = two-digit year. 

This command does not check the validity of the argument as does ONCE-only. 
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Characteristics 

The SET DATE command: 

leaves the console in monitor mode* 

Restrictions 

The user must be on device OPR or be logged in under [ 1 ,2] 

Associated Messages 
None 



SET CORMAX 



Function 



The SET CORMAX command is used to change the system parameter CORMAX. CORMAX 
is the largest size that any job can be. 



Command Format 



SET CORMAX n 

n = decimal number representing nK. This argument is required. 



Characteristics 



The SET CORMAX command: 

leaves the console in monitor mode. 



Restrictions 



The user must be on device OPR or be logged in under [ 1 ,2] 



Associated Messages 
None 
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SET CORMIN 



Functi 



on 



The SET CORMIN command is used to change the system parameter CORMIN. CORMIN 
is the guaranteed amount of contiguous core that a single unlocked job can have. This 
command .s used only with the real-time monitor. 

Command Form at 

SET CORMIN n 

n = decimal number representing nK. This argument is required. 

Characteristics 

The SET CORMIN command: 

leaves the console in monitor mode. 

Restrictions 

The user must be on device OPR or be logged in under [ 1 ,2] . 
Associated Messages 

None 



SET TIME 



Function 



The SET TIME command sets a central processor time limit for a job. When the time 
limit is reached, the fob is stopped and a message is typed. A timesharing job may be 
continued by typing CONT, but no time limit is in effect unless it is reset. A 
Batch job cannot be continued . 
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Command Format 



SET TIME n 



n = number of seconds of central processor time to which the job 
is limited. 



Characteristics 



The SET TIME command: 

leaves the console in monitor mode, 
requires LOGIN. 



Associated Messages 



?TIME LIMIT EXCEEDED 

The time allowed for the job has been reached. 



Exampl es 



^SET TIME 10^ 
• SET TIME b) 
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Chapter 3 

Loading User Programs 



3.1 MEMORY PROTECTION AND RELOCATION 

Each user program is run with the processor in a special mode known as the user mode, in which the 
program must operate within an assigned area in core. In user mode, certain operations are illegal. 
Every user has an assigned area in core; therefore the rest of core is unavailable to him. He cannot 
gain access to the protected area for either storage or retrieval of information. 

The assigned area of each user may be divided into two segments. If this is the case, the low segment 
is unique for a given user and can be used for any purpose. The high segment may be used by a single 
user or it may be shared by many users. If the high segment is shared by other users, the program is a 
reentrant program. The monitor can write-protect the high segment so that the user cannot alter its 
contents. This is done, for example, when the high segment is a pure procedure to be used reentrantly 
by many users. One high pure segment may be used with any number of low impure segments. (Refer 
to Chapter 1 for the distinctions between pure and impure segments.) Any user program which attempts 
to write in a write-protected high segment is aborted and receives an error message. If the monitor 
defines two segments but does not write-protect the high segment, the user has a two-segment non- 
reentrant program (refer to Paragraph 4.4.2). 

The Timesharing monitor defines the size and position of a user's area by specifying protection and 
relocation addresses for the low and high segment. The protection address is the maximum relative 
address the user can reference. The relocation address is the absolute core address of the first location 
in the segment, as seen by the monitor in the hardware. The monitor defines these addresses by loading 
four 8-bit registers (two 8-bit registers in a PDP-10 with the KT10 option instead of the KT10A option), 
each of which correspond to the left eight bits of an 18-bit PDP-10 address. Thus, segments always con- 
tain a multiple of 1024 words. 

In user mode, the PDP-10 hardware automatically relocates user addresses by adding the contents of 
the memory relocation register in the central processor to the high-order eight bits of the user address 
before the address is sent to memory. The address before the addition is the relative address and after 
the addition is the absolute address. To determine whether a relative address is legal, its eight 
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high-order bits are compared with the contents of the memory protection register. If the eight 
high-order bits of the relative address are greater than the contents of the memory protection register, 
the memory protection flag is set in the central processor, and control traps to the monitor, which 
aborts the user program and prints an error message on the user's console, unless the user program has 
instructed the monitor to pass such interrupts to itself for error-handling. (Refer to APRENB UUO, 
Paragraph 4.3.3. 1 .) 

Systems with the KT10 option have only the low pair of protection and relocation registers. The user 
program is always non-reentrant and the assigned area comprises only the low segment. 

When the monitor schedules a user's program to run, the memory protection and relocation registers 
are set to the bounds of the user's allocated core area and the central processor is switched to user 
mode. 

To take advantage of the fast accumulators, memory addresses 0-17 o are not relocated and all users 

o 

have access to the accumulators. Therefore, relative locations 0-17 o cannot be referenced by a 

o 

user's program. The monitor saves the user's accumulators in this area when the user's program is not 
running and while the monitor is servicing a UUO from the user. Refer to the PDP-10 System Reference 
Manual for a more complete description of the relocation and protection hardware. 

3.1.1 Memory Parity Error Recovery 

The memory parity error recovery code allows the machine to run with PARITY STOP up, thereby 
gaining 10% more CPU speed than with PARITY STOP enabled. This procedure differentiates between 
user mode and executive mode when a parity error occurs. If the machine was in user mode, the cur- 
rent job is stopped, and the word causing bad parity is rewritten with good parity. The following 
message is typed on the user's console: 

? ERROR IN JOB n 

? MEM PAR AT USER pppppp; BAD WORD dddddddddddd 
AT USER adr = ABS. xxxxxx 

and the following message is typed simultaneously on device OPR, interrupting any current typeout: 
? USER MODE PAR ERROR AT ABS LOC xxxxxx FOR JOB n 



where 



n is the job number of the current job 
pppppp is the user PC when the parity error occurred 
dddddddddddd is the bad data word read (expressed in octal) 
adr is the user address of the bad word 
xxxxxx is the absolute address of the bad word 
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If the machine was in executive mode when the parity error occurred, recovery is not attempted since 
a monitor routine has read bad data. The following message (with no carriage return, line feed fol- 
lowing) is typed on CTY and the machine HALTS: 

EXEC PARITY ERROR STOP 

At this point, the operator must depress the PARITY STOP key and hit CONTINUE. The machine 
should stop almost immediately with a memory failure. If the parity error is not reproducible on a 
memory scan, the following message is typed on the CTY on the same line as the previous message and 
the machine HALTS with the PC at 777777: 

SPURIOUS 

System reload is required after an executive mode memory parity failure. 

The algorithm for determining the bad memory location in both executive and user mode is to scan core 

from location 20 o through location C (MEMSIZ). In both modes, the parity error is detected at APR 
8 

interrupt level. For executive mode the memory scan when CONTINUE is hit runs at APR level. For 
user mode a clock level interrupt is requested, and the memory scan and subsequent typeouts are pro- 
cessed at this level. The following two counters are kept for user mode parity analysis: 

PARTOT - the total number of user mode parity errors since system 
was loaded. 

PARSPR - the number of errors for which recovery failed (no parity 
error on memory scan) and the job was not stopped. 

Also the counters PARPC, PARADR, and PARWRD contain the user PC, the absolute location, and the 
bad data word, respectively, of the most recent user mode memory parity error. 

3.2 USER'S CORE STORAGE 

A user's core storage consists of blocks of memory, the sizes of which are an integral multiple of 1024^ 

(2000-) words. In a non-reentrant monitor, the user's core storage is a single contiguous block of 

8 
memory. After relocation, the first address in a block is a multiple of 2000 g . The relative user and 

relocated address configurations are shown in Figure 3-1, where P , R. , P„, and R„ are the protection 

and relocation addresses, respectively, for the low and high segments as derived from the 8-bit registers 

loaded by the monitor. If the low segment is more than half the maximum memory capacity (P >400000), 

the high segment starts at the first location after the low segment (at P. + 2000). The high segment is 

limited to I28K. 
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Two methods are available to the user for loading his core area. The simplest way is to load a core 
image stored on a retrievable device (refer to RUN and GET, Chapter 2). The other method is to use 
the relocatable binary loader to link-load binary files. The user may then write the core image on a 
retrievable device for future use (refer to SAVE, Chapter 2). 

3.2.1 Job Data Area 

The first 140 octal locations of the user's core area are always allocated to the job data area (refer to 
Table 3-1). Location in this area are given mnemonic assignments where the first three characters are 
JOB. The job data area provides storage for specific information of interest to both the monitor and 
the user. Some locations, such as JOBSA and JOBDDT, are set by the user's program for use by the 
monitor. Other locations, such as JOBREL, are set by the monitor and are used by the user's program. 
In particular, the right half of JOBREL contains the highest legal address set by the monitor when the 
user's core allocation changes. 



P L + 1777 



400000 



Pu + 1777 



777777 



LOW 
SEGMENT 



ILLEGAL 



HIGH 
SEGMENT 



ILLEGAL 
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w 






/ 



/ 



y 



\ 



\ 



\ 



^ 



\ 



\ 



HIGH 
SEGMENT 



JOB DATA AREA 



LOW 
SEGMENT 



HARDWARE 
ACCUMULATORS 



17 



400000 



R H + P H +1777 



Rl 

R L +20 
R L +140 

R L + P L + '777 
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RELOCATION 



Figure 3-1 User's Core Area 



3-4 



Table 3-1 

Job Data Area Locations 

(for user-program reference) 



Name 



JOBUUO 
JOB41 

JOBERR 

JOBREL 

JOBBLT 

jjOBDDf 

J0BCN6 

JJOBPFI 
JOBHRL 



Octal 
Location 



40 
41 

42 
44 
45 

"74: 

106 



114 
(valve) 

115 



Description 



User's location 40 8 . Used for processing user UUOs (001 
through 037) and storing op code and effective address . 

User's location 41 g . Contains the beginning address of 
the user's programmed operator service routine (usually a 
JSRorPUSHJ). 

Left half: Unused. 

Right half: Accumulated error count from one CUSP to the 

next. CUSPs should be written to look at the right half 

only. 

Left half: 

Right half: The highest relative core location available 
to the user (i.e., the contents of the memory protection 
register when this user is running). 

Three consecutive locations when the LOADER puts a BLT 
instruction and a CALLI UUO to move the program down on 
top of itself. These locations are destroyed on every execu- 
tive UUO by the executive pushdown I ist . 

Left half: the last address of DDT. 
Right half: the starring address of DDT. 
DDT has not been loaded • 



If contents are 0, 



Six temporary locations used by CHAIN CUSP (refer to 
frmeshdring Handbook) after it releases all I/O channels. 
J0BCN6 Is defined to be in JOBJDA. 

All user I/O must be to locations greater than JOBPFI. 

Left half: First relative free location in the high segment 
(relative to the high segment origin so it is the same as 
the high segment length) . Set by the LOADER and sub- 
sequent GETs, even if there is no file to initialize the low 
segment. The left half is a relative quantity because the 
high segment can appear at different user origins at the 
same time. The SAVE command uses this quantity to know 
how much to write from the high segment. 
Right half: Highest legal user address in the high segment. 
Set by the monitor every time the user starts to run or does 
a CORE or REM^P UUO . The word is >401777 unless there 
is no high segment, In which case it wiM be zero. The 
proper way to test if a high segment exists is to test this 
word for a non-zero value. 
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Table 3-1 (Cont) 

Job Data Area Locations 

(for user-program reference) 



Name 



Octal 
Location 



Description 



JOBSYM 

JOBUSY 

JOBSA 

JOBFF 

JOBREN 
JOBAPR 



116 

117 
120 
121 

124 
125 



JOBCNI 
JOBTPC 
JOBOPC 



126 
127 
130 



Contains a pointer to the symbol table created by linking 

loader. 

Left half: Negative of the length of the symbol table. 

Right half: Lowest address used by the symbol table. 

Contains a pointer to the undefined symbol table created 
by linking loader. Not used by DDT. 

Left half: First free location in low segment (set by loader). 
Right half: Starting address of the user's program. 

Left half: 0. 

Right half: Address of the first free location following the 

low segment. Set to C(JOBSA) LH by RESET UUO. 

Left half: Unused. 

Right half: REENTER starting address. Set by user or by 
loader and used by REENTER command as an alternate 
entry point. 

Left ha If: 0. 

Right half: Set by user program to trap address when user 
is enabled to handle APR traps such as illegal memory, 
pushdown overflow, arithmetic overflow, and clock. See 
CALL APRENB UUO. 

Contains state of APR as stored by CONI APR when a 
user-enable APR trap occurs. 

Monitor stores PC of next instruction to be executed when 
a user-enabled APR trap occurs. 

The previous contents of the job's last user mode program 
counter are stored here by monitor on execution of a DDT, 
REENTER, START, or CSTART command. After a user pro- 
gram HALT instruction followed by a START, DDT, 
CSTART, or REENTER command, JOBOPC contains the ad- 
dress of the HALT. To proceed at the address specified by 
the effective address, it is necessary for the user or his 
program to recompute the effective address of the HALT 
instruction and to use this address to start. Similarly, after 
an error during execution of a UUO followed by a START, 
DDT, CSTART, or REENTER command, JOBOPC points to 
the address of the UUO. For example, In DDT to continue 
after a HALT, type 

JOBOPC/10000, ,3010 JRST @ $Q$X 
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fable 3-1 (Cont) 

Job Data Area Locations 

(for user-program reference) 



Name 


Octal 
Location 


Description 


JOBCHN 
JOBCOR 

JOBINT 
JOBVER 

JOBDA 


131 
133 

134 
137 

140 


Left half: or the address of first location after first 
FORTRAN IV loaded program. 

Right half: Address of first location after first FORTRAN IV 
Block Data. 

Left half: Highest location in low segment loaded with 
non-zero data. No low file written on SAVE or SSAVE 
if less than 140. Set by the LOADER. 
Right half: User argument on last SAVE or GET command. 
Set by the monitor. 

Left half: Reserved for the future. 

Right half: or the address of the error-intercepting 

block (refer to Paragraph 4.3.3.2). 

Left half: or the patch number of the installation that 
made the last modification to the program. 
Right half: Program version number in octal . The number 
is never converted to decimal . After a GET, R, or RUN 
command, an E command can be used to find the version 
number. (DEC always distributes CUSPs with the left half = 0, 
so customers making modifications to CUSPs should change 
only the left half. The right half will remain as a record 
of the DEC version.) 

The value of this symbol is the first location available to 
the user. 


NOTE: Only those JOBDAT locations of significant importance to the user are given in this 
table. JOBDAT locations not listed include those which are used by the monitor and those 
which are unused at present. User programs should not refer to any locations not listed above 
since such locations are subject to change. 



JOBDAT is loaded automatically, if needed, during the loader's library search for undefined global 
references and the values are assigned to the mnemonics. JOBDAT exists as a .REL file on device 
SYS for loading with user programs that symbolically refer to the locations. User programs should 
reference locations by the assigned mnemonics, which must be declared as EXTERN references to the 
assembler. All mnemonics in this manual with a JOB prefix refer to locations in the job data area. 



3.2.2 Loading Relocatable Binary Files 

The relocatable binary loader (LOADER), which resides in the system file, is started by the command 

R LOADER core 
Revision 1 Monitors 3-7 January 1971 



where core is an optional argument (see Figure 3-2). (Refer to the LOADER documentation in the 
PDP-10 Reference Handbook for a description of the loader command string.) 

In writing reentrant user software, an effort is made to minimize the support required to run such soft- 
ware on a machine having only a single relocation register. Both the source and relocatable binary 
files are the same for a reentrant program that must run on a non-reentrant system. 

The loader is reentrant; therefore, its instructions exist in the high segment. In loading two segments, 
both segments are data with respect to the loader and must exist in the low segment during load time. 
Therefore, the following loader variables must exist for each segment: 

a. Offset (the number of locations a program must be moved toward zero before it can be 
executed) 

b. Program origin (the location assigned by the loader to relocatable zero of a program) 

c. Location counter (the register that indicates the location of the next instruction to be 
interpreted). 

3.2.2. 1 H Switch - A program written to be reentrant can be loaded into one segment instead of two 
by use of the H switch i/\\). The H switch is used only when a two-segment program is to be loaded 
into one segment. It causes all following files to be loaded into the low segment. This switch is not 
required when a one-segment program is to be loaded into one segment. 

To minimize the use of the H switch on single-register machines, the loader checks if the system (i.e. , 
hardware plus software) has a two-segment capability. If the monitor has this capability but the 
machine does not, then the system does not have the two-segment capability. If the system does not 
have the two-segment capability, the loader automatically loads a two-segment program into one 
segment, just as if the user had typed the H switch. 

To find out if the system has a two-segment capability, the loader uses the SETUWP UUO and attempts 
to set the user mode write-protect bit to 1. An error return indicates a single-register capability. The 
loader cannot produce a two-segment program, and the monitor cannot save a program as two segments. 

If a user wants to load a program in which the low segment is longer than 400000 octal words, he uses 
the switch NNNNNNH, which changes the origin of the high segment from its initial setting of 
400,000 to NNNNNN where NNNNNN is larger. If NNNNNN is missing, the loader loads every- 
thing into the low segment. 

It is not known before load time whether a reentrant program is not going into the high segment; there- 
fore, the core executed (including the monitor UUOs) is the same for either case. 
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Figure 3-2 Loading User Core Area 



Modifications to the H switch 



a. Ca 



v.duse all following files to be loaded into the high-segment (/1H) and 

Reset the loader to load high segment code in the high segment and low segment code 
into the low segment (/-H). 



3.2.2.2 HISEG Pseudo-Op - After loading, a relocatable subprogram assembled by MACRO is put 
entirely in either the user low segment or the user high segment. To indicate that a subprogram is to 
be loaded into the high segment, the HISEG pseudo-op is used. Although the HISEG pseudo-op can 
appear anywhere in the program, the best position is at the beginning, because a reader wants to know 
that the program is destined for the high segment. Near the beginning of the binary output, MACRO 
generates code that tells the loader to load subprograms into the high segment. Loader Version 50 loads 
programs in any order. In earlier versions of the loader, all programs for the low segment must be 
loaded before any programs for the high segment. 

3.2.2.3 Vestigial Job Data Area - A few constant data in the job data area may be loaded by a two- 
segment, one-file program without using instructions on a GET command (JOB41, JOBREN, JOBVER) 
and some locations are loaded by the monitor on a GET (JOBSA, JOBCOR JOBHRL). The vestigial 
job data area (the first 10 locations of the high segment) is reserved for these low segment constants; 
therefore, a high segment program is loaded into 400010 instead of 400000 (refer to Table 3-2). With 
the vestigial job data area in the high segment, the loader automatically loads the constant data into 
the job data area without requiring a low file on a GET, R, or RUN command, or a RUN UUO. 
SAVE will write a low file for a two-segment program only if the LH of JOBCOR is 140„ or greater. 
The vestigial job data area locations are referenced by the monitor only, not by user programs. 



Table 3-2 
Vestigial Job Data Area Locations 



Symbol 


Octal 
Locationt 


Description 


JOBHSA 
JOBH41 
JOBHCR 
JOBHRN 



1 
2 
3 


A copy of JOBSA 

A copy of JOB41 

A copy of JOBCOR 

LH: restores the LH of JOBHRL 
RH: restores the RH of JOBREN 



I + Relative to origin of high segment, usually JOBHGH = 400000g. 
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Table 3-2 (Cont) 
Vestigial Job Data Area Locations 



Symbol 



JOBHVR 



JOBHDA 



Octal 
Locationt 



4 
5 
6 
7 
10 



Description 



A copy of JOBVER 
Reserved for future use 



First location not used by vestigial job data 
area. 



'Relative to origin of high segment, usually JOBHGH = 400000q. 



3.2.2.4 Completion of Loading - The new program code is loaded upward from an offset above the 
resident loader. The program origin (i.e. , the first location loaded) is 14CL, unless the user changes 
the origin by the assembler LOC pseudo-instruction. After completion of the loading but before 
exiting, the loader does the following: 

a . Sets the LH of JOBSA and the RH of JOBFF to the address of the first location above the 
new code area (i.e., the program break). The RH of JOBSA is set to the program starting 
address. This value is the last non-zero address of the assembler END pseudo-instruction 
to be loaded, or zero. It is used by the RUN and START commands. The LH of JOBFF 

is zero. 

b. Sets the LH of JOBHRL to the new highest relative user address (relative to the high seg- 
ment origin) in high segment, or zero if no high segment. 

c . Sets the LH of JOBCOR to the highest location in the low segment that is loaded with 
non-zero data. 

d. Uses REMAP UUO to take the top part of the low segment that contains the user's high 
segment, and replaces the loader high segment. 

e. May move symbols and reduce core, if DDT was loaded. 

f. Calls EXIT or starts up program. 

If DDT was loaded by the D switch in the loader command string, the RH of JOBDDT is set by the 
| loader to the starting address of DDT and the LH is the last address of DDT. A new switch, /K, 
implemented for use with DDT, moves core back to the absolute minimum needed. A/nK moves core 
back to nK, unless n is less than the minimum core, in which case the minimum core is assigned. The 
/D switch is used to imply /B/K . 



Revision 1 Monitors 



3-11 



January 1971 



Chapter 4 

User Programming 



4.1 PROCESSOR MODES 

In a single-user, no n -timesharing system, the user's program is subject only to those conditions inherent 
in the hardware. The program must 

a. Stay within the memory capacity 

b. Observe the hardware restrictions placed on the use of certain memory locations 

c. Observe the restriction on interrupt instructions. With timesharing, the hardware limits 
the central processor operations to one of three modes: user mode, user I/O mode, and 
executive mode. 



4. 1 . 1 User Mode 

User programs run with the processor in user mode must operate within an assigned area of core. In 
user mode, certain instructions are illegal. User mode is used to guarantee the integrity of the monitor 
and each user program. The user mode of the processor is characterized by the following: 

a. Automatic memory protection and relocation (refer to Chapter 3) 

b. Trap to absolute location 40 in the monitor on any of the following: 

(1) Operation codes 040 through 077 and operation code 00 

(2) Input/output instructions (DATAI, DATAO, BLKI, BLKO, CONI, CONO, CONSZ, 
and CONSO) 

(3) HALT (i.e., JRST4,) 

(4) Any JRST instruction that attempts to enter executive mode or user I/O mode 

c. Trap to relative location 40 in the user area on execution of operation codes 001 
through 037. 

4.1.2 User I/O Mode 

The user I/O mode (bits 5 and 6 of PC word = 11) of the central processor allows running privileged 
user programs with automatic protection and relocation in effect, as well as the normal execution of 
all defined operation codes. The user I/O mode provides some protection against partially debugged 
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monitor routines, and permits running infrequently used device service routines as a user job. Direct 
control by the user program of special devices is particularly important in real-time applications. 

To utilize this mode, the job number must be 1. CALL [SIX BIT /RESET/] or CALLI terminates user 
I/O mode. User I/O mode is not used by the monitor and is normally not available to the timesharing 
user (refer to Paragraph 4.10.10.1). 

4.1.3 Executive Mode 

The monitor operates with the processor in executive mode, which is characterized by the lack of 
memory protection and relocation (refer to Chapter 3) and by the normal execution of all defined 
operation codes. 

User programs run in user mode; therefore, the monitor must schedule user programs, service interrupts, 
perform all input and output operations, take action when control returns from a user program, and 
perform any other legal, user-requested operations that are not available in user mode. This chapter 
describes the services the monitor makes available to user-mode programs and how a user program ob- 
tains these services. 

4.2 PROGRAMMED OPERATORS (UUOs) 

Operation codes 000 through 077 in the PDP-10 are programmed operators, sometimes referred to as 
UUOs (Unimplemented User Operators) because from a hardware point of view, their function is not 
pre-specified. Some of these op-codes trap to the monitor and the rest trap to the user program. 

After the effective address calculation is complete, the contents of the instruction register, along with 
the effective address, are stored in user or monitor location 40 and the instruction in user or monitor 
location 41 is executed out of normal sequence. Location 41 must contain a JSR instruction to a rou- 
tine to interpret the contents of location 40. 

4.2.1 Operation Codes 001-037 (User UUOs) 

Operation codes 001 through 037 do not affect the mode of the central processor; thus, when executed 
in user mode, they trap to user location 40, which allows the user program complete freedom in the 
use of these programmed operators. 
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If a user's undebugged program accidentally executes one of these op-codes when the user did not 
intend to use it, the following error message is normally issued: 

ERROR IN JOB n 
ILLEGAL UUO AT USER 41 

This message is given because the user's relative location 41 contains zero (unless his program has 
overtly changed it) and 000 is an illegal monitor UUO. 

4.2.2 Operation Codes 040-077 and 000 (Monitor UUOs) 

Operation codes 040 through 077 and 000 trap to absolute location 40, with the central processor in 
executive mode. These programmed operators are interpreted by the monitor to perform I/O operations 
and other control functions for the user's program. 

Operation code 000 always returns the user to monitor mode with the error message: 

ERROR IN JOB n 

ILLEGAL UUO AT USER addr 

Table 4-1 lists the operation codes 040 through 077 and their mnemonics. Most of Chapter 4 is a de- 
tailed description of their operation. 



Op Code 



040 
041 



042 
043 
044 
045 
046 



Table 4-1 
Monitor Programmed Operators 



Call 



CALL AC, [SIXBIT/NAME/J 

INIT D, MODE 
SIXBIT /DEV/ 
XWD OBUF, IBUF 
error return 
normal return 



Function 



Programmed operator extension (refer to 
Paragraph 4.2.2.1) 

Select I/O device (refer to Paragraph 
4.10.2.3) 



No operation 

No operation 

No operation 

No operation 

No operation 
J 



i Reserved for installation- 
f dependent definition 
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Table 4-1 (Cont) 
Monitor Programmed Operators 



Op Code 


Call 


Function 


047 


CALLIAC, N 


Programmed operator extension (refer to 
Paragraph 4.2.2.1) 


050 


OPEN, D, E 


Select I/O device (refer to Paragraph 




error return 


4.10.2.3) 




normal return 






E: EXP STATUS 






SIXBIT /DEV/ 






XWDOBUF, IBUF 




051 


TTCALL AC, ADR 


Extended operations on job-controlling 
Teletype (refer to Paragraph 5^9.3) 


052 




Reserved for future expansion by DEC. 


053 




Reserved for future expansion by DEC. 


054 




Reserved for future expansion by DEC. 


055 


RENAME D, E 

error return 

normal return 

E: SIXBIT /FILE/ 
SIXBIT /EXT/ 
EXP<PROT>B8+DATE 
XWD PROJ, PROG 


Rename or delete a file (See Section 4. 10.4.3) 


056 


IN D, 


INPUT and skip on error or EOF. (See 




normal return 


Section 4.10.5) 




error or EOF return 




057 


OUT D, 


OUTPUT and skip on error or EOT. (See 




normal return 


Section 4.10.5) 




error return 




060 


SETSTS D, STATUS 


Set file status. (See Section 4.10.6.2) 


061 


STATO D, BITS 


Skip if file status bits = 1. (See 




R0: NO SELECTED BITS = 1 


Section 4.10.6.1) 




Rl: SOME SELECTED BITS = 1 




062 


GETSTS D, E 


Copy file status to E . (See Section 4. 10.6. 1) 


063 


STATZ D, BITS 


Skip if file status bits = 0. (See 




R0: SOME SELECTED BITS = 1 


Section 4.10.6.1) 




Rl: ALL SELECTED BITS = 




064 


INBUF D, N 


Set up input buffer ring with N buffers (refer 
to Paragraph 4.10.3.2) 


065 


OUTBUF D, N 


Set up output buffer ring with N buffers (refer 
to Paragraph 4. 10.3.2) 


066 


INPUT D, 


Request input or request next buffer (refer to 
Paragraph 4.10.5) 
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Table 4-1 (Cont) 
Monitor Programmed Operators 



Op Code 


Call 


Function 


067 


OUTPUT D, 


Request output or request next buffer (refer to 
Paragraph 4.10.5) 


070 


CLOSE D, 


Terminate file operation (refer to Paragraph 
4.10.7) 


071 


RE LEAS D, 


Release device (refer to Paragraph 4. 10.8. 1) 


072 


MTAPE D, N 


Perform tape positioning operation (refer to 
Paragraphs 5.5.3 and 6. 1.6.5) 


073 


UGETF D, 


Get next free block number on DECrape 
(refer to Paragraph 6. 1 .6.3) 


074 


USETI D, E 


Set next input block number (refer to 
Paragraphs 6.1.6.1 and 6.2.8.3) 


075 


USETO D, E 


Set next output block number (refer to 
Paragraphs 6.1 .6.2 and 6.2.8.3) 


076 


LOOKUP D, E 
error return 
normal return 
E: SIXBIT /tlLE/ 

SIXBIT /EXT/ 



XWD PROJ, PROG 


Select a file for input (refer to Paragraph 
4.10.4.1) 


077 


ENTER D, E 
error return 
normal return 
E: SIXBIT /t=ILE/ 

SIXBIT /EXT/ 



XWD PROJ, PROG 


Select a file for output (refer to a 
Paragraph 4. 10.4.2) 






100 


UJEN 


Dismiss real time interrupt (refer to 
Paragraph 4.10.10.2) 



4.2.2. 1 CALL and CALLI - Operation codes 040 through 077 limit the monitor to 40 operations. The 
CALL operation extends this set by specifying the name of the operation by the contents of the location 
specified by the effective address (e.g. , CALL [SIXBIT /EXIT/I ). This capability provides for in- 
definite extendabilily of the monitor operations, at the overhead cost to the monitor of a table lookup. 

The CALLI operation eliminates the table lookup of the CALL operation by having the programmer or 
the assembler perform the lookup and specify the index to the operation in the effective address of the 
CALLI. Table 4-2 lists the monitor operations specified by the CALL and CALLI operations. 
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Table 4-2 
CALL and CALL! Monitor Operations 



CALLI 


CALLI 
Mnemonic 


CALL 


Function 


CALLI AC, -2 
. . . -n 




Customer defined 


Reserved for definition by each 
customer installation. 


CALLI AC, -1 


LIGHTS 


CALL AC, [SIXBIT /LIGHTS/I 


Display AC in console lights 


CALLI AC, 


RESET 


CALL [SIXBIT /RESET/1 return 


Reset I/O device (refer to 
Paragraph 4.10.1.2) 


CALLI AC, 1 


DDTIN 


MOVEI AC, BUFFER 

CALL AC, [SIXBIT /DDTIN/I 

only return 


DDT mode console input (refer 
to Paragraph 5.9.2) 


CALLI AC, 2 


SETDDT 


MOVEI AC, DDT-start-adr 
CALL AC, [SIXBIT /SETDDT/1 
only return 


Set protected DDT starting 
address (refer to Paragraph 
4.3.1.1) 


CALLI AC, 3 


DDTOUT 


MOVEI AC, BUFFER 

CALL AC, [SIXBIT /DDTOUT/J 

only return 


DDT mode console output (refer 
to Paragraph 5.9.2) 


CALLI AC, 4 


DEVCHR 


MOVE AC, [SIXBIT /dev/3 or 
MOVEI AC, channel no. 
CALL AC, [SIXBIT /DEVCHR/3 
only return 

C(AC) = if no such device 
C(AC) = DEVMOD word of 

device data block if 
device is found. 


Get device characteristics, 
(refer to Paragraph 4.9.4.2) 


CALLI AC, 5 


DDTGT 


CALL AC, [SIXBIT /DDTGT/] 
only return 


No operation, historical UUO 


CALLI AC, 6 


GETCHR 


AC: = SIXBIT /DEV/ 

CALL AC, [SIXBIT /GETCHR/] 

only return 


Same as CALLI AC, 4 


CALLI AC, 7 


DDTRL 


CALL AC, [SIXBIT /DDTRL/] 
only return 


No operation; historical UUO 


CALLI AC, 10 


WAIT 


AC field is software channel number. 
CALL AC, [SIXBIT /WAIT/] 
only return 


Wait until device is inactive 
(refer to Paragraph 4. 10.5.3) 


CALLI AC, 11 


CORE 


MOVE AC, [XWD HIGH ADR or 
0, LOW ADR or 0] 
CALL AC, [SIXBIT /CORE/] 
error return, assignment unchanged 
normal return, new assignment 
AC: = max. core available 

(in IK blocks) on error 
or normal return. 


Allocate core (refer to 
Paragraph 4.4. 1) 
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Table 4-2 (Cont) 
CALL and CALLI Monitor Operations 



CALLI 


CALLI 
Mnemonic 


CALL 


Function 


CALLI AC, 12 


EXIT 


CALL AC, [SIXBIT /EXIT/I 
return 

If AC ^ 0, devices are not re- 
leased and CONT and CCONT 
commands are effective. 


Stop job, may release devices 
depending on contents of AC 
(refer to Paragraph 4.3.2.3) 


CALLI AC, 13 


UTPCLR 


AC field is software channel number 
CALL AC, [SIXBIT /UTPCLR/I 
only return 


Clear DECtape directory (refer 
to Paragraph 6. 1 .6.4) 


CALLI AC, 14 


DATE 


CALL AC, [SIXBIT /DATE/1 
only return 

AC: = date in compressed 
format 


Return date (refer to 
Paragraph 4.9.1.1) 


CALLI AC, 15 


LOGIN 


MOVE AC, [XWD -N, LOC] 
CALL AC, [SIXBIT /LOGIN/] 
R0: return 

Does not return if C(R0) is 
a HALT instruction. 


Privileged UUO available only to 
privileged programs (refer to 
Paragraph 4.7. 1) 


CALLI AC, 16 


APRENB 


MOVEIAC, BITS 

CALL AC, [SIXBIT /APRENB/J 

return 


Enable central processor traps 
(refer to Paragraph 4.3.3. 1) 


CALLI AC, 17 


LOGOUT 


CALL AC, [SIXBIT /LOGOUT/1 
no return 


Privileged UUO for use only by 
LOGOUT CUSP (refer to Para- 
graph 4.3.2.4) 


CALLI AC, 20 


SWITCH 


CALL AC, [SIXBIT /SWITCH/1 
return 

AC: = contents of console data 
switches 


Read console data switches (refer 
to Paragraph 4.9.4. 1) 


CALLI AC, 21 


REASSI 


MOVE AC, job number 

MOVE AC + 1 , [SIXBIT /DEV/1 

CALL AC, [SIXBIT /REASSI/1 

return 

If C(AC) = on return, the job 
specified has not been initial- 
ized. 

If C(AC+1) = on return, the 
device is not assigned to call- 
ing job, or device is TTY. 


Reassign device (refer to Para- 
graph 4.10.8.2) 


CALLI AC, 22 


TIMER 


call ac, [sixbit Aimer/] 

return 

AC: = time in jiffies, right- 
justified. 


Read time of day in clock ticks 
(refer to Paragraph 4.9. 1 .2) 
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Table 4-2 (Cont) 
CALL and CALLI Monitor Operations 



CALLI 


CALLI 
Mnemonic 


CALL 


Function 


CALLI AC, 23 


MSTIME 


CALL AC, CSIXBIT /MSTIME/] 
return 

AC: = time in milliseconds, right- 
justified 


Read time of day in milliseconds 
(refer to Paragraph 4.9.1.3) 


CALLI AC, 24 


GETPPN 


CALL AC, [SIXBIT /GETPPN/I 

normal return 

error return 

AC: = XWD proj. no., prog. no. 
of this job. Error return is 
taken only if job is 
privileged and the same proj- 
prog number occurs twice in 
the table of jobs logged in. 


Return project-programmer num- 
ber of job (refer to Paragraph 
4.9.2.3) 


CALLI AC, 25 


TRPSET 


MOVE AC, [XWD N, LOCJ 
CALL AC, [SIXBIT ARPSET/] 
error return 
normal return 
LOC: JSR TRAP 


Set trap for user I/O mode (refer 
to Paragraph 4.10.10.1) 


CALLI AC, 26 


TRPJEN 


CALL [SIXBIT /TRPJEN/1 


Illegal UUO; replaced by UJEN 
(op code 100) 


CALLI AC, 27 


RUNTIM 


MOVE AC, job number of 
CALL AC, [SIXBIT /RUNTIM/1 
only return 

AC: = running time of job 
AC: = if non-existent job 


Return the jobs running time in 
milliseconds (refer to Paragraph 
4.9.2.1) 


CALLI AC, 30 


PJOB 


CALL AC, [SIXBIT /PJOB/I 

return 

AC: = job number, right-justified 


Return job number (refer to Para- 
graph 4.9.2.2) 


CALLI AC, 31 


SLEEP 


MOVE AC, time to sleep in seconds 
CALL AC, [SIXBIT /SLEEP/] 
return 


Stop job for specified time in 
seconds (refer to Paragraph 
4.3.4.1) 


CALLI AC, 32 


SETPOV 


CALL AC, [SIXBIT /SETPOV/1 
return 


Superseded by APRENB UUO 


CALLI AC, 33 


PEEK 


MOVEI AC, execadr 

CALL AC, [SIXBIT /PEEK/] 

return 

AC: = C(exec-adr) 


Return contents of executive 
address (refer to Paragraph 
4.9.3.1) 


CALLI AC, 34 


GETLIN 


CALL AC, [SIXBIT /GETLIN/] 

return 

AC: = SIXBIT TTY name, left 

justified (e.g., CTY, TTY27) 


Return SIXBIT name of attached 
Teletype console (refer to Para- 
graph 4.9.2.4) 
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Table 4-2 (Cont) 
CALL and CALLI Monitor Operations 



CALLI 


CALLI 
Mnemonic 


CALL 


Function 


CALLI AC, 35 


RUN 


MOVSI AC, start adr increment 

HRRI AC, E 

RUN AC, 

error return 

normal return 

E: SIXBIT /DEVICE/ 

SIXBIT /FILE/ 

SIXBIT /EXT/ 



XWD proj no, prog no 

XWD 0; optional core assignment 


Transfer control to selected pro- 
gram (refer to Paragraph 4.5. 1) 








CALLI AC, 36 


SETUWP 


MOVEIAC, BIT 
SETUWP AC, 
error return 
normal return 


set or clear user mode write pro- 
tect for high segment (refer to 
Paragraph 4.4.2) 


CALLI AC, 37 


REMAP 


MOVEI AC, highest adr. in lowseg 
REMAP AC, 
error return 
normal return 


Remap top of low segment into 
high segment (refer to Paragraph 
4.5.3) 


CALLI AC, 40 


GETSEG 


MOVEIAC, E 
GETSEG AC, 
error return 
normal return 
E: SIXBIT /DEVICE/ 

SIXBIT /FILE/ 

SIXBIT /EXT/ 



XWD proj no, prog no 




Replace high segment in user's 
addressing space (refer to Para- 
graph 4.5.2) 








CALLI AC, 41 


GETTAB 


MOVSI AC, job no. or index no. 
HRRI AC, table no. 
GETTAB AC, 
error return 
normal return 

C(AC) unchanged on error return 
AC: = table entry if table is defined 
and index is in range. 


Return contents of monitor table 
or location (refer to Paragraph 
4.9.3.3) 


CALLI AC, 42 


SPY 


MOVEI AC, highest physical adr. 

desired 

SPY AC, 

error return 

normal return 


Make physical core be high seg- 
ment for examination of monitor 
(refer to Paragraph 4.9.3.2) 
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CALLI 



CALLI 
Mnemonic 



CALLI AC, 43 



CALLI AC, 44 



SETNAM 



TMPCOR 



CALLI AC, 45 



DSKCHR 



CALLI AC, 46 



SYSSTR 



CALLI AC, 47 



JOBSTR 



CALLI AC, 50 



STRUUO 



Table 4-2 (Cont) 
CALL and CALLI Monitor Operations 



CALL 



MOVE AC, [SIXBIT /NAME/I 

SETNAM AC, 

return 

MOVE AC, [XWD CODE, BLOCK] 

TMPCOR, 

error return 

normal return 

BLOCK: XWD NAME, 

IOWDBUFLEN, BUFFER 
AC:= value depending on CODE and 

whether error or normal return 

is taken. 

MOVE AC, [XWD + N, LOC] 

DSKCHR AC, 

error return 

normal return 

AC: =XWD status, configuration 

LOC: = SIXBIT /NAME/ 



J 



values returned 



MOVEIAC, Oor 
MOVE AC, [SIXBIT /FSNAME/] 
SYSSTR AC, 

error return - not a file structure 
normal return 

AC: = next file structure name in 
SIXBIT, left-justified 

MOVE AC, [XWD N, LOO 
JOBSTR AC, 
error return 
normal return 
AC: = argument 

Contents Use 

LOC/SIXBIT/NAME/or- I arg 
LOC+1/XWDprojno, 

prog. no. value 

LOC+2/status bits value 

MOVE AC, [XWD N, LOC] 

STRUUO AC, 

error return 

normal return 

AC: = status or error code 



Function 



Set program name in monitor job 
table (refer to Paragraph 4.7.2) 

Allow temporary in-core file stor- 
age for job (refer to Paragraph 
4.8.1) 



Return disk characteristics (refer 
to Paragraph 4.9.4.4) 



Return next file structure name 
(refer to Paragraph 4.9.4.5) 



Return next file structure name in 
the jobs search list (refer to Para- 
graph 4.9.2.5) 



Manipulate file structures. 
Function is the only unprivileged 
function (refer to Paragraph 4.6. 1) 
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Table 4-2 (Cont) 
CALL and CALLI Monitor Operations 



CALLI 



CALLI AC, 50 
(continued) 



CALLI 
Mnemonic 



CALLI AC, 51 



CALLI AC ,52 
CALLI AC ,53 



CALLI AC ,54 



CALLI AC ,55 



CALLI AC ,56 
CALLI AC ,57 

CALLI AC ,60 
CALLI AC ,61 



STRUUO 



SYSPHY 



FRECHN 
DEVTYP 



DEVSTS 



DEVPPN 



SEEKtt 



RTTRP 



LOCK 



JOBSTS 



CALL 



Contents 

LOC/function 

numbers 
LOC+1/ 



Use 



arg 

arg depending 

on function 

number 



Function 



MOVEI AC, or last unit name 
SYSPHY AC, 
error return 
normal return 



MOVE AC, [SIXBIT/dev/l or 
MOVEI AC, channel no. 
DEVTYP AC, 
error return 
normal return 

MOVEI AC, channel no. of device 
DEVSTS AC, 
error return 
normal return 

MOVE AC, [SIXBIT/DEV/1 
DEVPPN AC, 
error return 
normal return 

AC: = XWD proj-prog . number 
on a normal return 

AC is software channel number 

SEEK AC, 

return 

MOVEI AC, RTBLK 
RTTRP AC, 
error return 
normal return 

LOCK AC, 
error return 
normal return 

MOVEI AC , channel no . or 
MOVNIAC, job 
JOBSTS AC, 
error return 
normal return 



Return all physical disk units 
(refer to Paragraph 4.9.4.8) 



Reserved for future use. 

Return properties 

of device (refer to Paragraph 

4.9.4.5). 



Return hardware device status 
word (refer to Paragraph 
4.9.3.4) 

Return the project programmer 
number associated with a device 
(refer to Paragraph 4.9.4.3) 



Perform a SEEK to current selected 
block for software channel AC 
(refer to Paragraph 6.2.6.3) 

Connect real-time 
devices to PI system 
(refer to Paragraph 8.3) 

Lock job in core (refer to 
Paragraph 8.2) 

Return status information about 
device TTY and/or controlled 
job (refer to Paragraph 5.10.4.4) 
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Table 4-2 (Cont) 
CALL and CALLI Monitor Operations 





CALLI 






CALLI 


Mnemonic 


CALL 


Function 


CALLI AC ,62 


LOCATE 


MOVEI AC, location 


Change the job's logical location 






LOCATE AC, 


(refer to the Remote Batch Manual) 






error return 








normal return 




CALLI AC, 63 


WHERE 


MOVEI AC, channel no. or 


Return the physical location of a 






MOVE AC, [ SIXBIT/dev/3 


device (refer to the Remote Batch 






WHERE AC, 


Manual). 






error return 








normal return 




CALLI AC, 64 


DEVNAM 


MOVEI AC, channel no. or 


Return physical name of device 






MOVE AC, CSIXBIT/dev/I 


obtained through generic I NIT/ 






DEVNAM AC, 


OPEN or logical device assign- 






error return 


ment (refer to the Remote Batch 






normal return 


Manual). 


CALLI AC ,65 


CTLJOB 


MOVE AC, job number 


Return job number of controlling 






CTUOB AC, 


job (refer to Paragraph 5.10.4.5) 






error return 








normal return 




CALLI AC, 66 


GOBSTR 


MOVE AC, [XWD N,LOC] 


Return next file structure name 






GOBSTR AC, 


in an arbitrary job's search list 






error return 


(refer to Paragraph 4.9.2.6) 






normal return 








LOC: SIXBIT/NAME/or -1 








LOC + 1 : job number 








LOC + 2: XWD proj no, prog no 








LOC + 3:0 








LOC + 4: Status bits 


^ 


CALLI AC ,67 


ACTIVATE 




J Reserved for the future 


CALLI AC ,70 


DEACTIVATE 




J 


CALLI AC ,71 


HPQ 


MOVE AC, high-priority queue no. 


Place job in high priority scheduler's 






HPQUUO AC, 


run queue (refer to Paragraph 8.5). 






error return 








normal return 




CALLI AC ,72 


HIBER 


MOVSI AC, enable bits 


Allow job to become dormant until 






HRRI AC, sleep time 


the specified event occurs (refer to 






HIBER AC, 


Paragraph 4.3.4.2) 






error return 








normal return 




CALLI AC ,73 


WAKE 


MOVE AC, job no. 


Allow job to activate the specified 






WAKE AC, 


dormant job (refer to Paragraph 






error return 


4.3.4.3) 






normal return 


■ 
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Table 4-2 (Cont) 
CALL and CALLI Monitor Operations 



CALLI 



CALLI AC ,74 



CALLI AC ,75 



CALLI AC, 76 



CALLI AC ,77 



CALLI AC, 100 



CALLI AC, 101 



CALLI 

Mnemonic 



CHGPPN 



SETUUO 



DEVGEN 



OTHUSR 



CHKACC 



DEVSIZ 



CALL 



MOVE AC, new proj. prog. no. 
CHGPPN AC, 
error return 
normal return 



MOVE AC, [XWD function, argument] Set system and job parameters 



Function 



Change project-programmer number 
(refer to Paragraph 4.7.4) 



SETUUO AC, 
error return 
normal return 

MOVE AC, SIXBIT/dev/ 
DEVGEN AC, 
error return 
normal return 

OTHUSR AC, 
non-skip return 
skip return 
AC: = proj.prog.no. 

MOVE AC, [EXP LOC] 
CHKACC AC, 
error return 
normal return 

LOC: XWD action, protection 
LOC + 1: directory proj -prog no. 
LOC + 2: user proj-prog no. 

MOVE AC, [EXP LOC] 
DEVSIZ AC, 
error return 
normal return 

LOC: EXP STATUS 
LOC+ 1: SD<BIT/dev/ 



(refer to Paragraph 4.7.3) 



Return range and station of generic 
device (refer to the Remote Batch 
Manual) 

Determine if another job is logged 
in with same project-programmer 
number (refer to Paragraph 4.9.2.7) 

Check user's access to the file 
specified (refer to Paragraph 
6.2.8.3) 



Determine buffer size for the 
specified device (refer to 
Paragraph 4.9.4.6) 



The CALLI mnemonics are defined in a separate MACRO Assembler Table, which is scanned if an 
undefined OP CODE is found. If the symbol is found in the CALLI Table, it is defined as though it 
had appeared in an appropriate OPDEF statement, that is 

RETURN : EXIT 
If EXIT is undefined, it will be assembled as though the program contained the statement 

OPDEF EXIT [CALLI 12] 
This facility is available in MACRO V.43 and later. 

All CALLI "s above CALLI 55 do not have a corresponding CALL with a SIXBIT argument. This is to 
save monitor table space. 
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The customer is allowed to add his own CALL and CALLI calls to the monitor. A negative CALLI effective 
address (-2 or less) should be used to specify such customer-added operations. 

4.2.2.2 Suppression of Logical Device Names - Some CUSPs,e.g. LOGOUT, require J/O to specific 
physical devices regardless of the logical name assignments. Therefore, for any CALLI, if bit 19 
(UPHNLY) is 1 , only physical names will be used; logical device assignments will be ignored. This 
suppression of logical device names is helpful, for example, when using the results of the DEVNAM 
UUO where the physical name corresponding to a logical name is returned. 

I 4.2.2.3 Restriction on Monitor UUOs in Reentrant User Programs - A number of restrictions on UUOs 
that involve a high segment prevent naive or malicious users from interferring with other users while 
sharing segments and minimize monitor overhead in handling two-segment programs. The basic rules 
are as follows: 

a. All UUOs can be executed from the low or high segment although some of their arguments 
cannot be in, or refer to, the high segment. 

b. No buffers, buffer headers, or dump-mode command lists may exist in the high segment 
for reading from or writing to any I/O device. 

c . No I/O is processed into or out of the high segment except via the SAVE and SSAVE 
commands . 

d. No STATUS, CALL or CALLI UUO allows a store in the high segment. 



Revision 1 Monitors 4-12b January 1971 



e. The effective address of the LOOKUP, ENTER, INPUT, OUTPUT, and RENAME UUOs 
cannot be in the high segment. If any rule is violated, an address check error message is 
given (refer to Table 2-11). 

f. As a convenience in writing user programs, the monitor makes a special check so that the 
INIT UUO can be executed from the high segment, although the calling sequence is in the 
high segment. The monitor also allows the effective address of the CALL UUO (contains 
the SIXBIT monitor function name) and the effective address of the OPEN UUO (contains 
the status bits, device name, and buffer header addresses) in the high segment. The ad- 
dress of TTCALL 1, and TTCALL 3, may be in the high segment for convenience in typing 
messages. 



4.2.3 Operation Codes 100-127 (Unimplemented Op Codes) 

Op code 100-UJEN Dismiss real-time interrupt from user mode 

(refer to Paragraph 8.4.2) 

Op codes 101-127 Monitor prints ILL INST AT USER n and stops 

the job. 



4.2.4 Illegal Operation Codes 

The eight I/O instructions (e.g. , DATAI) and JRST instructions attempting to enter executive or user 
I/O mode from the user mode are interpreted by the monitor as illegal instructions. The job is stopped 
and the following error message is printed on the user's console: 

ERROR IN JOB n 

ILL INST AT USER addr 



4.3 EXECUTION CONTROL 

4.3.1 Starting 

A user program may start another program only by using the RUN or GETSEG UUOs (refer to Para- 
graph 4.5. 1 and 4.5.2). A console user may start a program with the monitor commands RUN , START, 
CSTART, CONT, CCONT, DDT, and REENTER (refer to Chapter 2). The starting address is either an 
argument of the command or stored in the user's job data area (refer to Chapter 3). 

| 4.3.1. 1 SETDDT AC, or CALLI AC, 2 - This UUO causes the contents of the AC to replace the DDT 
starting address, which is stored in the protected job data area location, JOBDDT. The starting ad- 
dress is used by the monitor command, DDT (refer to Paragraph 3.2.2.4). 
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4.3.2 Stopping 

Any of the following procedures can stop a running program: 

a. One t C from user console if user program is in a Teletype input wait; otherwise, two t C's 
from user console (refer to Chapter 2); 

b. A monitor detected error 

c. Program execution of HALT, CALL CSIXBIT /EXIT/1 , or CALL [SIXBIT /LOGOUT/I . 

4.3.2. 1 Illegal Instructions (700-777, JRST 10, JRST 14) and Unimplemented OP Codes (101-127) - 
Illegal instructions trap to the Monitor, stop the Job, and print: 

ERROR IN JOB 

ILL INST AT USER adr 

Note that the program cannot be continued by typing the CONT or CCONT commands. 

4.3.2.2 HALT or JRST 4 - The HALT instruction is an exception to the illegal instructions; it traps to 
the monitor, stops the job, and prints: 

ERROR IN JOB 
HALT AT USER n 

where n is the location of the HALT instruction. 

However, the CONT and CCONT commands are still valid and, if typed, will continue the program 
at the effective address of the HALT instruction. After a user program HALT instruction followed by a 
START, DDT, CSTART, or REENTER command, JOBOPC contains the address of the HALT. To proceed 
at the address specified by the effective address, it is necessary for the user or his program to recompute 
the effective address of the HALT instruction and to use this address to start (refer to JOBOPC descrip- 
tion, Table 3-1). HALT is not the instruction used to terminate a program (refer to Paragraph 4.3.2.3). 
HALT is useful for indicating impossible error conditions. 

4.3.2.3 EXIT AC, or CALLI AC, 12 - When the value of AC is zero, all I/O devices (including real- 
time devices) are RELEASed (refer to Paragraph 4. 10.8. 1), the Job is unlocked from core, the user mode 
write protect bit (UWP) for the high segment is set, the APR traps are reset to 0, the PC flags are cleared, 
and the job is stopped. If timesharing was stopped (refer to Paragraph 8.4), it is resumed. In other 
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words, after releasing all I/O devices which close out all files, a RESET is done (refer to Paragraph 
4. 10. 1 .2). The carriage-return and line-feed is performed and 

EXIT 



is printed on the user's console, which is left in monitor mode. The CONT and CCONT commands 
cannot continue the program. 

When AC is 1, the job is stopped, but devices are not released and a RESET is not done. Instead of 
printing EXIT, only a carriage-return and line-feed is performed and a period is printed on the user's 
console. The CONT and CCONT commands may be used to continue the program. In other words, 
this form of EXIT does not affect the state of the fob except to stop it and r?turn the console to monitor 
mode. Programs using EXIT 1, as a substitute for EXIT (to eliminate the typing of EXIT) should 
RELEASE all devices first. 

4.3.2.4 CALL [SIXBIT /LOGOUT/1 or CALLI 17 - All I/O devices are RELEASed (refer to Para- 
graph 4. 10.8.1), and returned with the allocated core and the job number to the monitor pool . The 
accumulated running time of the job is printed on the user's console, which is left in monitor mode. 
This UUO is not available to user programmers, but is only for use by the LOGOUT CUSP. If a user 
program executes a LOGOUT UUO, the monitor will treat it like EXIT (refer to Paragraph 4.3.2.3). 

4.3.3 Trapping 

4.3.3. 1 APRENB AC, or CALLI AC, 16 - APR trapping allows a user to handle any and all traps that 
occur while his job is running on the central processor, including illegal memory references, non- 
existent memory references, pushdown list overflow, arithmetic overflow, floating point overflow, 
and clock flag. To enable for trapping, a CALL AC, [SIXBIT /APRENB/1 or CALLI AC, 16 is 
executed, where the AC contains the central processor flags to be tested on interrupts, as defined 
below: 





AC Bit 


Trap On 


18 


400000 


Repetitive enable 


19 


200000 


Pushdown overflow 


22 


20000 


Memory protection violation 


23 


10000 


Nonexistent memory flag 


26 


1000 


Clock flag 


29 


100 


Floating-point overflow 


32 


10 


Arithmetic overflow 
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When one of the specified conditions occurs while the central processor is in user mode, the state of 
the central processor is conditioned into (CONI) location JOBCNI, and the PC is stored in location 
JOBTPC in the job data area (refer to Table 3-1). Then control is transferred to the user trap-answering 
routine specified by the contents of the right half of JOBAPR, after the arithmetic overflow and floating 
point overflow flags are cleared. The user program must set up location OBJAPR before executing the 
CALL AC, [SIXBIT /APRENB/I or CALLI AC, 16. To return control to his interrupted program, the 
user's trap-answering routine must execute a JRSTF @ JOBTPC to restore the state of the processor. 

The APRENB UUO normally enables traps for only one occurrence of any selected condition and must 
be reissued after each condition of a trap. To disable this feature, set bit 18 to a 1 when executing 
the UUO. However, even with bit 18 = 1, clock interrupts must be re-enabled after each trap. 

If the user program does not enable traps, the monitor sets the PDP-10 processor to ignore arithmetic 
and floating-point overflow, but enables interrupts for the other error conditions in the list above. If 
the user program produces such an error condition, the monitor stops the user job and prints 

ERROR IN JOB n 

followed by one of the following appropriate messages: 

PC OUT OF BOUNDS AT USER addr 
ILLMEMREF ATUSERaddr 
NON-EX MEM AT USER addr 
PDLOV AT USER addr 

The CONT and CCONT commands will not succeed after such an error. 

4.3.3.2 Error Intercepting - Device errors that can be corrected by human intervention are intercepted 
by the monitor, and control may be returned to the user program when the error is rectified. When 
these errors are detected, the monitor examines location JOBINT in the job data area. If this location 
is zero, the job is stopped and both the user and the operator are notified. The user receives the 
message 

OPRzz ACTION REQUESTED FOR DEVICE xxx 

where zz is the number of the station at which the operator is located in the case of Remote Batch, 
and xxx is the device name . The operator receives the message 

OPERATE ON DEVICE xxx FOR JOB n 

where xxx is the device name, and n is the number of job that is stopped. When the operator has 
corrected the error, he starts the job with the JCONT command and the message 
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CO NT BY OPER 
appears on the user's console signifying that the error has been corrected. 

If location JOBINT is non-zero, the contents is interpreted as the address of a block with the following 

format: 

LOC : XWD N,INTLOC 
LOC + l:XWDBITS,CLASS 
LOC + 2: 
LOC +3: 

where N is the number of words in the block (N >3). 

INTLOC is fhe location at which the program is to be restarted 
BITS is a set of bits interpreted as the following: 

if bit — 1 , an error message is not to be typed on the user's Teletype, 
if bit = 0, an error message is to be typed on the user's Teletype. 

CLASS is a set of bits interpreted as the following: 

if bit 35 - 0, the job is to be stopped and a message is to be typed 
on the user's Teletype. 

if bit 35 = 1 , bit (BITS) is examined to see if a message is to be typed. 
Bits 18-34 are reserved for future types of errors. 

The monitor examines the CLASS bits first. If Bit 35 is zero, the user and the operator are given 
messages (see above), and the job is stopped. If Bit 35 is 1 , the monitor examines LOC +2 in the 
block. If this location is non-zero, the messages are typed to the user and the operator, and the job 
is stopped. If the location LOC +2 is zero, the monitor examines bit (BITS) to determine if a message 
should be typed. The following information is then stored in LOC +2 whether or not a message was 
typed: 

LOC+2 the last user PC word 

LOC +3 RH = the channel number 

LH = the error bit as defined in CLASS 

The job is then started at location INTLOC . 

4.3.3.3 Console-Initiated Traps - Program control can be regained from the user's console by use of 
the tC command (refer to Chapter 2). 

4.3.4 Suspending 

4.3.4.1 CALL AC, [ SIXBIT /SLEEP/] or CALLI AC, 31 - This UUO stops the job, and continues 
automatically after an elapsed real time of [C(AC) x clock frequency] modulo 2'^ jiffies. The contents 
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of the AC are thus interpreted as the number of seconds the job wishes to SLEEP; however, there is an 
implied maximum of approximately 68s (82s in 50-Hz countries) or 1 min. 

4.3.4.2 HIBER AC, or CALLI AC,72 

The HIBERNATE UUO allows a }ob to become dormant until a specified event occurs. The possible 
events that can wake a hibernating job are: 1) user's Teletype input activity (both line mode and 
character mode), 2) PTY activity for any PTY currently INITed by this job, 3) I/O activity for any 
I/O device INITed by this job, 4) the time-out of a specified amount of sleep time, or 5) the issuance 
of a WAKE UUO directed at this job either by some other job with wake-up rights or by this job at 
interrupt level. 

The HIBERNATE UUO must contain in the left half of AC the wake-conditon enable bits, and in the 
right half the number of ms for which the job is to sleep before it is awakened. 



The call is as follows: 



MOVSI AC, enable bits 
HRRI AC, sleep time 
HIBER AC, 
error return 
normal return 



;get HIBERNATE conditions 
;number of ms to sleep 
;or CALLI AC, 72 



The HIBERNATE UUO enable condition codes are as follows: 



Bits 
18-35 

15-17 

13-14 
12 



Meaning 



Number of ms sleep time. means no clock request 
(i.e., infinite sleep) . 

Wake protection code. 
Bit 17 = 1 , project codes must match. 
Bit 16 = 1 , programmer codes must match* 
Bit 15 = 1 , only this job can wake itself. 

TTY input activity. 

Bit 14 = 1 , wake on character ready. 

Bit 13 = 1 , wake on line of input ready. 

PTY activity since last HIBERNATE. 



An error return is given if the UUO is not implemented. Return is given on a normal return after an 
enabled condition occurs. 

Jobs either logged-in as Cl ,2] or running with the JACCT bit on can wake any hibernating job regard- 
less of the protection code. This allows privileged programs, which are the only jobs that can wake 
certain system jobs, to be written. 
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A RESET UUO always clears the protection code and wake-enable bits for the job. Therefore, until 
the first HIBERNATE UUO is called, there is no protection against wake-up commands from other 
jobs. To guarantee that no other job wakes the job, a WAKE UUO followed by a HIBERNATE UUO 
with the desired protection code should be executed. The WAKE UUO ensures that the first HIBER- 
NATE UUO always returns immediately, leaving the job with the correct protection code. 



4.3 .4.3 WAKE AC, or CALLI AC ,73 - The WAKE UUO allows one job to activate a dormant job 
when some event occurs. This feature may be used with Batch so that when a job wants a core dump 
taken, it can wake up a dump program. Also, real-time process control jobs can cause other process 
control jobs to run in response to a specific alarm condition. The WAKE UUO can be called for a 
RTTRP job running at interrupt level (refer to Paragraph 8.3), thereby allowing a real-time job to 
wake its background portion quickly in order to respond to some real-time condition. 



The call is as follows: 



MOVE AC, JOBNUM 
WAKE AC, 
error return 
normal return 



;number of job to be awakened 
;or CALLI AC ,73 



An error return is given if the proper wake privileges are not specified. There is a wake bit associated 
with each job. If any of the enabled conditions specified in the last HIBERNATE UUO occurs, then 
this bit is set. The next time a HIBERNATE UUO Is executed, this bit is cleared and the HIBERNATE 
UUO returns immediately. This bit eliminates the problem of a job going to sleep and missing any 
wake conditions. 

On a normal return , the job has been awakened . 
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4.4 CORE CONTROL 

4.4.1 CALL AC, CSIXBIT /CORE/I orCALLI, 11 

This UUO provides a user program with the ability to expand and contract its core size as its memory 
requirements change. To allocate core in either or both segments, the left half of AC is used to specify 
the highest user address to be assigned to the high segment. If the left half of AC contains 0, the high 
segment core assignment is not changed. If the left half of AC is non-zero and is either less than 
400000 or the length of the low segment, whichever is greater, the high segment is eliminated. If this 
is executed from the high segment, an illegal memory error message is printed when the monitor at- 
tempts to return control to the illegal address. 

The error return is given if LH is greater than or equal to 400000 and if either the system does not have 
a two-segment capability or the user has been meddling without write access privileges (refer to Para- 
graph 6.2.3). An RH of leaves the low segment core assignment unaffected. The monitor clears new 
core before assigning it to the user; so therefore privacy of information is ensured. 

In swapping systems, these programmed operators return the maximum number of IK core blocks (all of 
core minus the monitor, unless an installation chooses to restrict the amount of core) available to the 
user. By restricting the amount of core available to users, the number of jobs in core simultaneously 
is increased. In nonswapping systems, the number of free and dormant IK blocks are returned; therefore, 
the CORE UUO and the CORE command return the same information. 



The call is: 



MOVE AC [XWD HIGH ADR or 0, LOW ADDR or 0] 
CALL AC, [SIX BIT /CORE/] orCALLIAC, 11 

error return 
normal return 



The CORE UUO reassigns the low segment (if RH is non-zero) and then reassigns the high segment (if 
LH is non-zero). If the sum of the new low segment and the old high segment exceeds the maximum 
amount of core allowed to a user, the error return is given, the core assignment is unchanged, and the 
maximum core available to the user for high and low segments (in IK blocks) is returned in the AC. In 
a nonswapping system, the number of free and dormant IK blocks is returned. 

If the sum of the new low segment and the new high segment exceeds the maximum amount of core al- 
lowed to a user, the error return is given, the new low segment is assigned, the old high segment re- 
mains, and the maximum core available to the user in IK blocks is returned in the AC. Therefore, to 
increase the low segment and decrease the high segment at the same time, two separate CORE UUOs 
should be used to reduce the chances of exceeding the maximum size allowed to a user job. 



4-17 



If the new low segment extends beyond 377777, the high segment shifts up into the virtual addressing 
space instead of being overlaid. If a long low segment is shortened to 377777 or less, the high seg- 
ment shifts from the virtual addressing space to 400000 instead of growing longer or remaining where 
it was. If the high segment is a program, it does not execute properly after a shift unless it is a self- 
relocating program in which all transfer instructions are indexed. 

If the high segment is eliminated by a CORE UUO, a subsequent CORE UUO, in which the LH Is 
greater than 400000, will create a new, nonsharable segment rather than reestablishing the old high 
segment. This segment becomes sharable after it has been: 

a. Given an extension .SHR 

b. Written onto the storage device 

c. Closed so that a directory entry is made 

d. Initialized from the storage device by GET,R, or RUN commands or RUN or GETSEG UUOs. 

The loader and the SAVE and GET commands use the above sequence to create and initialize new 
sharable segments. 

| 4.4.2 SETUWP AC, or CALLI AC, 36 

This UUO allows a user program to set or clear the hardware user-mode write protect bit and to obtain 
the previous setting. It must be used if a user program is to modify the high segment. 

The call is: 

| SETUWP AC, ; OR CALLI AC, 36 

error return 
normal return 

If the system has a two-register capability, the normal return will be given unless the user has been 
meddling without write privileges, in which case an error return will be given. An error return is 
given whether or not the program has a high segment, because the reentrant software is designed to 
allow users to write programs for two-register machines, which will run under one-register machines. 
Compatibility of source and relocatable binary files is, therefore, maintained between one-register 
and two-register machines. 

If the system has a one-register capability, the error return (bit 35 of AC=0) is given. This error return 
allows the user program to find out whether or not the system has a two-segment capability. The user 
program specifies the setting of the user-mode write protect bit in bit 35 of AC (write protect = 1 , 
write privileges = 0). The previous setting of the user-mode write protect bit is returned in bit 35 of AC, 



4-18 



so that any user subroutine can preserve the previous setting before changing it. Therefore, nested 
user subroutines, which either set or clear the bit, can be written, provided the subroutines save the 
previous value of the bit and restore it on returning to its caller. 

4.4.3 LOCK AC, or CALLI AC, 60 

This UUO locks jobs in core; refer to Paragraph 8.2. 

4.5 SEGMENT CONTROL 

4.5.1 RUN AC, or CALLI AC, 35 

This UUO has been implemented so that programs can transfer control to one another. Both the low 
and high segments of the user's addressing space are replaced with the program being called. 

The call is: 

MOVSI AC, starting address increment 
HRRI AC, Adr of six-word argument block 
RUN AC, or CALLI AC, 35 
error return (unless HALT in LH) 
[normal return is not here, but to starting 
address plus increment of new program] 

The arguments contained in the six-word block are: 

E: SIXBIT/logical device name/ 

SIXBIT/filename/ ;for either or both high and low files 

SIXBIT/ext. for low file/ ;if LH = 0, . LOW is assumed if high 

segment exists, .SAV is assumed if 
high segment does not exist. 



XWD proj. no. , prog. no. ;if = 0, use current user's proj,prog 

XWD 0, optional core ;RH = new highest user address to be 

assignment assigned to low segment. 

LH is ignored rather than setting high 
segment 

A user program usually will specify only the first two words and set the others to 0. The RUN UUO 
destroys the contents of all of the user's ACs and releases all the user's I/O channels; therefore, argu- 
ments or devices cannot be passed to the next program. 

1 The RUN UUO to certain system programs (e.g., LOGIN, LOGOUT) automatically sets the appropriate 
privileged bits (JACCT and JLOG). Assigning a device as SYS does not cause these bits to be set. 
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The RUN UUO clears all of core. However, programs should not count on this action, and must still 
initialize core to the desired value to allow programs to be restarted by a tC, START sequence without 
having to do I/O. 

Programs on the system library (CUSPs) should be called by using device SYS with a zero project- 
programmer number instead of device DSK with the project-programmer number 1 , 4. The extension 
should also be so that the calling user program does not need to know if the called CUSP is reentrant 
or not. 

The LH of AC is added to and stored in the starting address (JOBSA) of the new program before control 
is transferred to it. The command tC followed by the START command restarts the program at the lo- 
cation specified by the RUN UUO, so that the user can start the current CUSP over again. The user is 
considered to be meddling with the program if the LH of AC is not or 1 . (Refer to Paragraph 4.5.4.) 

Programs accept commands from a Teletype or a file, depending on how they were started, due to con- 
trol by the program calling the RUN UUO. The following convention is used with all of DEC's standard 
CUSPs: in LH of AC means type an asterisk and accept commands from the Teletype. A 1 means ac- 
cept commands from a command file, if it exists; if not, type an asterisk and accept commands from the 
Teletype. The convention for naming CUSP command files is that the filename be of. the form 

###III.TMP 

where III are the first three (or fewer if three do not exist) characters of the name of the CUSP doing 
the LOOKUP and *"* is the decimal character expansion (with leading zeroes) of the binary job number. 
The job number is included to a I low a user to run two or more jobs under the same project-programmer 
number. For example, 

009PIP.TMP 
039MAC.TMP 

Decimal numbers are used so that a user listing his directory can see the same number as the PJOB 
command types. These command files are temporary and are, therefore, deleted by the LOGOUT 
CUSP. (Refer to KJOB command in Chapter 2.) 

The RUN UUO can give an error return with one of 20 error codes in AC if any errors are detected; 
thus, the user program may attempt to recover from the error/give the user a more informative message 
on how to proceed. Some user programs do not go to the bother of including error recovery code. The 
monitor detects this and does not give an error return if the LH of the error return location is a HALT 
instruction. If this is the case, the monitor simply prints its standard error message for that type of 
error and returns the user's console to monitor mode. This optional error recovery procedure also allows 
a user program to analyze the error code received and then execute a second RUN UUO with a HALT 
if the error code indicates an error for which the monitor message is sufficiently informative or one from 
which the user program cannot recover. 
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The error codes are an extension of the LOOKUP, ENTER, and RENAME UUO error codes and are 
defined in the S.MAC monitor file. Refer to Appendix E for an explanation of the error codes. 

The monitor does not attempt an error return to a user program after the high or low segment containing 
the RUN UUO has been overlaid. 

To successfully program the RUN UUO for all size systems and for all CUSPs with a size that is not 
known at the time the RUN UUO is coded, it is necessary to understand the sequence of operations 
the RUN UUO initiates. Assume that the job executing the RUN UUO has both a low and a high 
segment. (It can be executed from either segment; however, fewer errors can be returned to the user 
if it is executed from the high segment.) 

The sequence of operations for the RUN UUO is as follows. 

1 . Does a high segment already exist with desired name ? 
If yes, go to 30. 

INIT and LOOKUP filename .SHR. If not found, go 
to 10. 

Read high file into top of low segment by extending 
it. (Here the old low segment and new high segment 
and old high segment together may not exceed the 
capacity of core.) 

REMAP the top of low segment replacing old high 
segment in logical addressing space. 
If high segment is sharable (.SHR) store its name 
so others can share it. 
Always go to 40 or return to user if GETSEG UUO. 

10. LOOKUP file name .HGH. If not found, go to 41 or 
error return to user if GETSEG UUO. 
Read high file into top of low segment by extending 
it. (The old low segment and new high segment and 
old high segment together may not exceed the 
capacity of core.) 

Check for I/O errors. If any, error return to user 
unless HALT in LH of return. 
Go to 41 . 

30. Remove old high segment, if any, from logical 
addressing space. 

Place the sharable segment in user's logical 
addressing space. Go to 40 or return to user if 
GETSEG UUO. 

35. Remove old high segment, if any, from logical 
addressing space. 
(Go to 41) 



40. 



Copy vestigial job data area into job data area. 
Does the new high segment have a low file 
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(LH JOBCORM37)? 
If not, go to 45. 



41 . LOOKUP filename .SAV or .LOW or user specified 
extension . Error if not found . Return to user if 
there is no HALT in LH of error return, provided 
that if the CALL is from the high segment it is 
still the original high segment. Otherwise, the 
monitor prints the error message 

?filename.SAV NOT FOUND 



and stops the job . 

Reassign low segment core according to size of file 
or user specified core argument, whichever is 
larger. Previous low segment is overlaid. Read 
low file into beginning of low segment. Check for 
I/O errors. If there is an error print error message 
and do not return to user. If there are no errors, 
perform START. 

45. Reassign low segment core according to larger of 
user's core argument or argument when file saved 
(RH JOBCOR). 

NOTE 

To be guaranteed of handling the largest number of errors, 
the cautious user should remove his high segment from high 
logical addressing space (use core UUO with a one in LH 
of AC). The error handling code should be put in the low 
segment along with the RUN UUO and the size of the low 
segment reduced to IK. A better idea would be to have 
the error handling code written once and put in a seldom 
used (probably nonsharable) high segment, which could be 
gotten in high segment using GETSEG UUO (see below) 
when an error return occurs to low segment on a RUN UUO. 



4.5.2 GETSEG AC, or CALLI AC, 40 

This UUO has been implemented so that a high segment can be initialized from a file or shared segment 
without affecting the low segment. It is used for shared data segments, shared program overlays, and 
run-time routines such as FORTRAN or COBOL operating systems. This programmed operator works 
exactly like the RUN UUO with the following exceptions: 

a . No attempt is made to read a low file. 

b. The accumulators are not preserved. JOBDAT is not changed except for the setting of 
JOBHRL. 

c. If an error occurs, control is returned to the location of the error return, unless the left 
half of the location contains a HALT instruction. 
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n a _T? ■ retUrn ' COntr ° is returned fo tw ° locations following the UUO, whether it is 
called from low or high segment. It should be called from low segment unless the normal 
return coincides with the starting address of the new high segment. 

e. User channels 1 through 17 are not released so the GETSEG UUO can be used for program 
overlays, such as the COBOL compiler. Channel is released because it is used by the UUO. 

f. JOBSA and JOBREN are zeroed if they point to a high segment that is being removed. This 
produces the message 

?NO START ADDRESS 

Refer to steps 1 through 31 of the RUN UUO description (Paragraph 4.4.2) for details of GETSEG UUO 
operation . 

4.5.3 REMAP AC, or CALLI AC, 37 

This UUO takes the top part of a low segment and remaps it into the high segment. The previous high 
segment (if any) will be removed from the user's addressing space. The new low segment will be the 
previous low segment minus the amount remapped. 

The cal I is: 

MOVEI AC, Desired highest adr in low segment 
REMAP AC, ; or CALLI AC, 37 
error return 
normal return 

To ensure that the amount remapped is a multiple of IK decimal words, the monitor performs the in- 
clusive OR function of 1777 and the user's request. If the argument exceeds the length of the low 
segment, remapping will not take place, the high segment will remain unchanged in the user's addressing 
space, and the error return will be taken. The error return will also be taken if the system does not have 
a two-register capability. The contents of AC are unchanged. The contents of JOBREL (refer to Para- 
graph 3.2. 1) are set to the new highest legal user address in the low segment. The RH of JOBHRL will 
be set to the highest legal user address in the high segment (401777 or greater or 0). The hardware re- 
location will be changed and the user-mode write protect bit will be set. 

This UUO is used by the LOADER to load reentrant programs, which make use of all of physical core. 
Otherwise, the LOADER might exceed core in assigning additional core and moving the data from the 
low to the high segment with a BLT instruction. The GET command also uses this UUO to perform I/O 
into the low segment instead of the high segment. 

4,5.4 Testing for Sharable High Segments 

Occasionally, it is desirable for a program to determine whether its high segment is sharable. If the 
high segment is sharable, the program may decide not to modify itself. The following code tests the 
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GETTAB 


T, 


JRST 


.+2 


TLNN 


T, 200000 


JRST 


NOTSHR 



high segment whether or not 1) the system has a high segment capability or 2) the fob has a high 
segment. 

HRROI T, 14 ;See if high segment is sharable 

;look at monitor JBTSGN table 
;table or UUO not present 
;is sharable bit on? 
;no, go ahead and modify here 
;if high segment is sharable. 



4.5.5 Modifying Shared Segments and Meddling 

A high segment is usually write-protected, but it is possible for a user program to turn off the user 
write-protect bit or to increase or decrease a shared segment's core assignment by using the SETUWP 
or CORE UUOs. These UUOs are legal from the high or low segment, if the sharable segment has not 
been "meddled" with unless the user has write privileges for the file that initialized the high segment. 
Even the malicious user can have the privilege of running such a program, although he does not have 
the access rights to modify the file used to initialize the sharable segment. 

Meddling is defined as any of the following, even if the user has privileges to write the file which 
initialized the sharable segment. 

a . START or CSTART commands with an argument 

b. DEPOSIT command in the low or high segment 

c. RUN UUO with anything other than a or 1 in LH of AC as a starting address increment. 

d. GETSEG UUO. 

It is not considered meddling to perform any of the above commands or UUOs with a nonsharable pro- 
gram. It is never considered meddling to type tC followed by START (without an argument), CONT, 
CCONT, CSTART (without an argument), REENTER, DDT, SAVE, or E command. 

When a sharable program is meddled with, the monitor sets the meddle bit for the user. An error return 
is given when the clearing of the user write-protect bit is attempted with the SETUWP UUO or when the 
reassignment of core for the high segment (except to remove it completely) is attempted with the CORE 
UUO. An attempt to modify the high segment with the DEPOSIT command causes the message 

OUT OF BOUNDS 

to be printed. If the user write-protect bit was not set when the user meddled, it will be set to protect 
the high segment in case it is being shared. The command and the two UUOs are allowed in spite of 
meddling, if the user has the access privileges to write the file which initialized the high segment. 
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A privileged programmer is able to supersede a sharable program, which is in the process of being 
shared by a number of users. When a successful CLOSE, OUTPUT, or RENAME UUO is executed for 
a file with the same directory name and filename (previous name if the RENAME UUO is used) as the 
segment being shared, the name of the segment is set to 0. New users do not share the older version, 
but they do share the newer version. This requires the monitor to read the newly created file only 
once to initialize it. The monitor deletes the older version when all users are finished sharing it. 

Users with access privileges are able to write programs that access sharable data segments via the 
GETSEG UUO (which is meddling) and then turn off the user write-protect bit using SETUWP UUO. 
With DECtape, write privileges exist if it is assigned to the job (cannot be a system tape) or is not 
assigned to any job and is not a system tape. 

When control can be transferred only to a small number of entry points (two), which the shared program 
is prepared to handle, then the shared program can do anything it has the privileges to do, although the 
person running the program does not have these privileges. 

The ASSIGN (and DEASSIGN, FINISH, KJOB if device was previously assigned by console) command 
clears all shared segment names currently in use, which were initialized for the device, if the device 
is removable (DTA,MTA). Otherwise, new users could continue to share the old segment indefinitely, 
even if a new version were mounted on the device. Therefore, it is possible to update the library dur- 
ing regular timesharing, if the programmer has access privileges. In a DECtape system, a new CUSP 
tape can be mounted followed by an ASSIGN SYS command, which clears segment names for the 
physical device, but does not assign the device because everyone needs to share it. 

4.6 FILE STRUCTURE CONTROL 
| 4.6.1 STRUUO AC, orCALLI AC, 50 

This UUO manipulates file structures and is intended primarily for monitor support CUSPs. 

The first word of the argument list specifies the function to be performed. Function (.FSSRC) is the 

I only unprivileged function; the other functions are used with the OMOUNT and UMOUNT CUSPs and 
are not discussed in this manual since they are not meant for general use. 



The call is: 



MOVE AC, [XWD N, LOC] 



STRUUO AC, 
error return 
normal return 
(Continued on next page) 



N is the number of words in the 

argument list starting at location 

LOC. 

or CALLI AC, 50 

AC contains an error code 

AC contains status information 
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LOC/ .FSSRC 

LOC+1/ First SIXBIT filestructure name, left justified 

LOC+2/ 

LOC+3/ Status bits 

LOC+4/ Second SIXBIT file structure name, left justified 

LOC+5/ 

LOC+6/ Status bits 



4.6.1 . 1 Function .FSSRC - This function allows a new file structure search list to be specified for 
the job issuing the UUO. The argument list consists of word triplets, which specify the new search 
list order to replace the current search list. The current search list may be determined with the 
JOBSTR UUO. The first word contains a left-justified file structure name in SIXBIT. The second 
word is not used at present. The third word contains the following status bits: 

i Bit = 1 if software write-protection is requested for this file structure. 

Bit 1 = 1 if files are not to be created on this file structure unless the specific 
file structure is specified in an ASSIGN command or in a INIT or 
OPEN UUO. 

The user may use the MOUNT command to add a new file structure name to his search list. The 
MOUNT CUSP 

a. Requests the file structure to be mounted (if it is not already mounted) 

b. Creates a UFD for the user if he has a logged-in quota in file SYS: QUOTA. SYS on that 
file structure. 

A user cannot create files on a file structure unless he or the project-programmer number specified has 
a UFD on that file structure. However, by using the .FSSRC function, the user may add a file structure 
name to his search list if the file structure is mounted and either the user has a UFD for that file struc- 
ture or he does not want to write on that file structure. If the user attempts to delete a file structure 
name from his search list by the .FFSRC function, the monitor moves the file structure name from the 
active search list to the passive search list. However, because the mount count is not decremented, 
the user may still do I/O explicitly to the file structure. The DISMOUNT command must be used to 
remove the file structure from the active or passive search list. The DISMOUNT command causes the 
mount count to be decremented, signifying that the user is finished with the file structure, and checks 
that the user has not exceeded his logged-out quota on that file structure. 
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Table 4-3 
.FSSRC Error Codes 



Symbol 


Code 


Explanation 


.ERILF 





Illegal function code 


.ERSNF 


1 


One or more file structures not found. 


.ERSSA 


2 


One or more file structures single 
access only. 


.ERTME 


4 


Too many entries in search list. 


.ERRSL 


17 


File structure is repeated in a search 
list definition. 



1 4.7 PROGRAM AND PROFILE IDENTIFICATION 

4.7. 1 CALL AC, [SIXBIT /LOGIN/] or CALLI AC, 15 

This UUO is not available to user programmers. It is for the exclusive use of the LOGIN CUSP, which 
uses this operator to exit to the monitor and to pass it certain crucial parameters (including project and 
programmer numbers) about the user who just successfully logged in. When the LOGIN CUSP calls this 
UUO, any devices the CUSP was using are released, and a period is printed on the user's console. 

The console is left in monitor mode ready to accept the user's first command. 

Any other user program that calls this UUO receives the error message 
ILLEGAL UUO AT USER addr 

The user's console is then put in monitor mode, and the CO NT and CCONT commands are not permitted. 

4.7.2 CALL AC, [SIXBIT /SETNAM/I or CALLI AC, 43 

This UUO is used by the LOADER. The contents of AC contain a left-justified SIXBIT program name, 
which is stored in a monitor job table. The information in the table is used by the SYSTAT CUSP 
(refer to Table 4-4). 
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4.7.3 SETUUO AC, or CALLI AC, 75 

The SETUUO is used to set various system or job parameters. Certain functions of this UUO are 
privileged. Privileges are granted if the job is either logged in under [1,2] or running with the JACCT 
bit on. The contents of AC contain a function code in the left half and an argument in the right half. 
The functions and arguments are as follows: 

Function Argument 

CORMAX (actual number). Privileged function. 

1 CORMIN (actual number). Privileged function. 

2 DAYTIME (decimal number of minutes since midnight, 
hours * 1 00 + minutes) . Privi I eged function . 

3 SCHED (argument stored in RH of STATES word in 
COMMON). Privileged function. 

4 CDR (input name counter for this job). If AC is non- 
zero , the contents is the same as the next input name . 
If 0, the current counter is returned in AC . Not a 
privileged function. 

5 SPOOL for this job (bits are as stored in JBTSPL). 
Not a privileged function. 

6 WATCH for this fob (bits are as stored in JBTWCH). 
Not a privileged function. 

7 DATE (decimal number of days since January 1 , 1964, 
refer to Paragraph 4.9.1.1). Privileged function . 

4.7.4 CHGPPN AC, or CALLI AC, 74 - This UUO is used by the LOGIN CUSP to change a user's 
project-programmer number. The call is: 

MOVE AC, new project-programmer number 

CHGPPN AC, ;or CALLI AC, 74 

error return 

normal return 

The error return is given if the UUO is not implemented or if the job associated with the project- 
programmer is already logged in. The normal return is given if the job is not logged in, and the 
project-programmer number is changed. 
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4.8 INTER-PROGRAM COMMUNICATION 

4.8.1 CALL AC, [SIXBIT /TMPCOR/I orCALLIAC, 44 

This allows a fob to leave several short files in core from the running of one user program or CUSP to 
the next. These files are referenced by a three-character filename and are unique to each job. All 
files are deleted when the job is killed. This system of temporary storage improves response times and 
reduces the number of disk operations. 

Each temporary file appears to the user as one dump mode buffer. The actual size of the file, the 
number of temporary files a user can have, and the total core a user can use for temporary storage are 
parameters determined at MONGEN time. All temporary files reside in a fixed area, but the space 
is dynamically allocated among different jobs and several different files for any given fob. 

The call is: 

MOVE AC, [XWD CODE, BLOCK] 

CALL AC, [SIXBIT AEMPCOR/I ;or CALLI AC, 44 

error return 

normal return 

BLOCK: XWD NAME, ; NAME is filename 

IOWD BUFLEN, BUFFER ;US er buffer area 

;(zero for no buffer) 

The AC must be set by the user program prior to execution of the UUO and is changed by the UUO on 
return to a value that depends on the particular function performed. Functions of the TMPCOR UUO 
are presented in the following paragraphs. 

4.8.1.1 CODE = 0, Obtain Free Space - This is the only form of the UUO that does not use a two- 
word parameter block and, therefore, the contents of AC are ordinarily set to 0. A normal return is 
given (unless the UUO is not implemented) and the number of free words available to the user is re- 
turned in AC. 



4.8. 1 .2 CODE = 1 , Read File - If the specified file is not found, the number of free words available 
for temporary files is returned in AC and the error return is taken. If the specified file is found, the 
length of the file in words is returned in AC, and as much of the file as possible is copied into the 
user's buffer. The user may check for truncation of the file by comparing the contents of AC with 
BUFLEN. 
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4.8.1 .3 CODE - 2, Read and Delete File - This function is similar to code = 1 , except that if the 
specified file is found, it is deleted and its space is reclaimed. 

4.8.1.4 CODE = 3, Write File - If a file exists with the specified name, it is deleted and its space 
reclaimed. The requested size of the file is specified by BUFLEN. If there is enough space 

a. The file is written 

b. The number of remaining blocks is returned in AC 

c. The normal return is taken 

If there is not enough space to completely write the file 

a. The file is not written 

b. The number of free words available to the user is returned in AC 

c. The error return is taken. 

4.8.1.5 CODE = 4, Read Directory - The number of different files in the temporary file area of the 
job is returned in AC. An entry is made for each file in the user's buffer area until either there is no 
more space or all files have been listed. The error return is never taken. The user may check for 
truncation of the entries by comparing the contents of AC with BUFLEN. The format of a directory 
entry is as follows: 

XWD NAME, SIZE 
where NAME is the filename and SIZE is the file length in words. 

4.8.1.6 CODE = 5, Read and Clear Directory - This function is similar to CODE = 4, except that any 
files in the temporary storage area of the fob are deleted and their space is reclaimed. 

This UUO is used by the LOGOUT CUSP. 

4.9 ENVIRONMENTAL INFORMATION 

4.9.1 Timing Information 

The central processor clock, which generates interrupts at the power-source frequency (60 Hz in North 
America, 50 Hz in most other countries), keeps time in the monitor. Each clock interrupt (tick) cor- 
responds to l/60fh (or 1/50th) of a second of elapsed real time. The clock is set initially to the current 
time by console input when the system is started, as is the current date. When the clock reaches mid- 
night, it is reset to zero, and the date is advanced. 
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4.9. 1 . 1 CALL AC, CSIXBIT /DATE/] or CALLI AC, 14 - A 12-bit binary integer computed by the 
formula 

date=((year-1964)xl2+(month-l))x31+day-I 

represents the date. 

This integer representation is returned right justified in accumulator AC. 

4.9.1.2 CALL AC, [SIX BIT /TIMER/] or CALLI AC, 22 - This UUO returns the time of day, in clock 
ticks (jiffies), right justified in accumulator AC. 

4.9.1.3 CALL AC, [SIXBIT /MSTIME/I or CALLI AC, 23 - This UUO returns the time of day, in 
milliseconds, right justified in accumulator AC. 

4.9.2 Job Status Information 

4.9.2.1 CALL AC, [SIXBIT /RUNTIM/I or CALLI AC, 27 - The accumulated running time (in milli- 
seconds) of the job number in accumulator AC is returned right justified in accumulator AC. If the 
job number in AC is zero, the running time of the currently running job is returned. If the job number 
in AC does not exist, zero is returned. 

4.9.2.2 CALL AC, [SIXBIT /P JOB/1 or CALLI AC, 30 - This UUO returns the job number right justi- 
fied in accumulator AC. 

4.9.2.3 CALL AC, [SIXBIT /GETPPN/1 or CALLI AC, 24 - This UUO returns in AC the project- 
programmer pair of the job. The project number is a binary number in the left half of AC, and the 
programmer number is a binary number in the right half of AC. If the program is LOGIN or LOGOUT 
from the system device, a skip return is given if the old project-programmer number is also logged in on 
another job. 

4.9.2.4 CALL AC, [SIXBIT /GETLIN/1 or CALLI AC, 34 - This UUO returns the SIXBIT physical 
name of the Teletype console that the program is attached to. 

The call is: 

CALL AC, [SIXBIT/GETLIN/] ;OR CALLI AC, 34 

The name is returned left justified in the AC . 
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Example: 



CTY or TTY3 or TTY30 



This UUO is used by the LOGIN program to print the TTY name. 

4.9.2.5 CALL AC, ESIXBIT /JOBSTR/1 or CALLI AC, 47 - This UUO returns the next file structure 
name in the job's search list along with other information about the file structure. Programs like PIP 
use this UUO to list a user's directory correctly and specify in which file structures the files occur, as 
well as the order in which they are scanned. 



The call is: 



MOVE AC, CXWD N,LOCl 
CALL AC , [SIXBIT /JOBSTR/J 
error return 
normal return 



;or CALLI AC, 47 



LOC is the address of an N-word block. The first word of this block should contain either -1 or the 
last value returned by the previous JOBSTR. On return, the first word is either the next file structure 
name or -1 if all file structure names have been returned. The second word contains the project- 
programmer number requested in the file structure, and the third word contains status bits. Current 
status bits include the following: 

Bit = 1 if software write protection is in effect for this job. 

Bit 1 = 1 if files are not to be created on this file structure, when a multiple 
file structure name is specified in an INIT or OPEN UUO. Files 
can be created if a specific file structure or physical unit is specified. 

4.9.2.6 GOBSTR AC, or CALLI AC, 66 - This privileged UUO returns successive file structure names 
I in the search list of either an arbitrary job or the system. The GOBSTR UUO is a generalization of the 
JOBSTR UUO (see Paragraph 4.9.2.5). 



The 



call is: 



MOVE AC, CXWD N,LOC] 
GOBSTR AC, 
error return 
normal return 



;or CALLI AC, 66 

;AC contains an error code 
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When the UUO is called, AC specifies the length (N) and address (LOC) of an argument list. N may 
be 0, 3, 4, or 5 where N - has the same effect as N = 3. Only the arguments included by N(LOC, 
LOC+1,. . .,LOC+N-l) are used or returned. The argument list is as follows: 



LOC: 


SIXBIT /file structure 


name/ 


;or -1 




job number 




;job whose search 
; list is desired. 




XWD prof, prog 




;project-programmer 
;number of above job. 









;currently unused. 




Status 




/status bits are the same 
;as in JOBSTR UUO. 



If the iob number and project-programmer number are both zero, the system search list is searched. 
On an error return, AC contains one of the following error codes: 

Code Meaning 

If LOC is not -1 or a file structure name in jobs 
search list. 

1 If job issuing the UUO is not privileged. 

2 If job number (LOC + I) and project-programmer 
number (LOC +2) do not correspond. 

4.9.2.7 OTHUSR AC, or CALLI AC, 77 - This UUO is used to determine if another job is logged In 
with the same project-programmer number as the job executing the UUO. The non-skip return ?s given 
if 

1) the UUO is not implemented, in which case the AC remains unchanged, or 

2) the UUO is implemented and no other jobs are logged in with the same project- 
programmer number, in which case the AC contains the project-programmer 
number of the job executing the UUO. 

The SKIP return is given if the UUO is implemented and other jobs are logged-in with the same project- 
programmer number. The AC contains the project-programmer number of the job executing the UUO. 
| This UUO is used by KJOB. 

4.9.3 Monitor Examination 

4.9.3. 1 PEEK AC, or CALLI AC, 33 - This UUO allows a user program to examine any location in 
the monitor. It is used by SYSTAT, FILDDT, and DATDMP and could be used for on-line monitor 
debugging. Some customers may want to restrict the use of this UUO to project I. 
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The call is: 



MOVEI AC, exec address 
PEEK AC, 



;TAKEN MODULO SIZE OF MONITOR 
;OR CALLI AC, 33 



This call returns with the contents of the monitor location in AC. 

4.9.3.2 SPY AC, or CALLI AC, 42 - This UUO is used for efficient examination of the monitor during 
timesharing. Any number of K of physical core (not limited to the size of the monitor) is placed into 
the user's logical high segment. This amount cannot be saved with the monitor SAVE command (only 
the low segment is saved), cannot be increased or decreased by the CORE UUO (error return taken), 
or cannot have the user-mode write protect bit cleared (error return taken). 
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The call is: 

MOVEI AC, highest physical core location desired 

SPY AC, " ;orCALLIAC, 42 

error return 

normal return 

Any program that is written to use the SPY UUO should try the PEEK UUO if it receives an error return. 
Some installations may restrict use of the SPY UUO to certain privileged users (e.g., project 1 only). 

4.9.3.3 GETTAB AC, or CALLI AC, 41 - This UUO provides a mechanism which will not vary from 
monitor to monitor for user programs to examine the contents of certain monitor locations. 

The call is: 

MOVE AC, [XWD index, table number] 

GETTAB AC, ;OR CALLI AC, 41 

error return 

normal return 

The left half of AC contains a job number or some other index to a table. Some job numbers may refer 
to high segments of programs by using arguments greater than the highest job number for the current 
monitor. A LH of -1 inidcates the current job number. A LH of -2 references the job's high segment. 
An error return is given if there is no high segment or if the hardware and software is non-reentrant. 
The right half of AC contains a table number from the list of monitor data tables and parameters in 
Table 4-4. The entries in these tables are globals in the monitor subroutine COMMON. The actual 
values of the core addresses of these locations are subject to change and can be found in the LOADER 
storage map for the monitor. The complete description of these globals is found in the listing of 
COMMON. 

The customer is allowed to add his own GETTAB tables to the monitor. A negative right half should 
be used to specify such customer-added operations. 

An error return leaves the AC unchanged and is given if the job number or index number in the left 
half of AC is too high, the table number in the right half of AC is too high, or the user does not have 
the privilege of accessing that table. 

A normal return supplies the contents of the requested table in AC, or a zero if the table is not defined 
in the current monitor. 

The SYSTAT CUSP makes frequent use of this UUO. 

NOTE 

Many GETTAB tables have information in the undescribed 
bits. This information is likely to change and should be 
ignored. Because the field is currently zero, there is no 
reason to believe that it will always be zero. 
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Table 4-4 
GETTAB Tables 



Table Numbers 
(RH of AQ 



00 
01 

02 



15 
16 
17 

20 



21 
22 



Table Names 



JBTSTS 
JBTADR 

PRJPRG 



03 


JBTPRG 


04 


TTIME 


05 


JBTKCT 


06 


JBTPRV 


07 


JBTSWP 


10 


TTYTAB 


11 


CNFTBL 


12 


NSWTBL 


13 


SWPTBL 


14 


JBTSGN 



ODPTBL 
LVDTBL 
JBTRCT 

JBTWCT 



JBTDBS 
JBTTDB 



Explanation 



Job status word; index by fob or segment number. 

Job relocation and protection; index by job or 
segment number. 

Project and programmer numbers; index by job or 
segment number. 

User program name; index by job or segment number. 

Total time used; index by job number. 

Kilo- Core ticks of job; index by job number. 

Privilege bits of job; index by job number. 

Swapping Parameters of job; index by job or seg- 
ment number. 

Teletype-to-job translation; index by console 
line number. 

Configuration table; index by item number, see 
below, 

Nonswapping data; index by item number, see below. 

Swapping data; index by item number, see below. 

High segment table; index by job number. 
Bit 0=0, then bits 18-35 is index of high segment 
(if bits 18-35 =0, then there is no high segment). 
Bit = 1 , then bits 18-35 is number of K to spy on. 
Bit 1 = 1 if job has a high segment that is sharable. 

Once-only disk parameters; index by item number, 
see below. 

Level D disk parameters; index by item number, 
see below. 

Disk blocks read by job; used by DSK command: 

a. Bits 0-11 = incremental blocks. 

b. Bits 12-35 = total blocks since LOGIN. 
Index by job number. 

Disk blocks written by job: 

a. Bits 0-11 = incremental blocks. 

b. Bits 12-35 = total blocks since LOGIN. 
Index by job number. 

Reserved for future. 

a. Bits 0-16 = time of day in seconds of last disk 
allocation. 

b. Bits 17-35 = number of disk blocks allocated on 
all file structures of this job; index by job num- 
ber. 
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ANSWER TO SOFTWARE TROUBLE REPORT 10-1406 



Diagnosis: The user asked user DDT to put break in a sharable 
high segment. This caused the sharable high segment to be 
modified with the JSR instruction. Subsequent GETS do not 
change the sharable high segment. This is the whole point of 
sharable segments, file 10 is minimized. 

Solution: To avoid this problem, it is advisable to debug with 
non-sharable high segments using the SAVE command instead of the 
SSAVE. 

Since this is not an obvious pitfall, I am submitting a sugges- 
tive STR to DDT, that it not allow breakpoints in a high segment 
if it is sharable. 

Also, an addition to the Reference Manual will describe how a 
program may determine if its high seg is sharable. 

DOCUMENTATION CORRECTION: 

Document: Time Sharing Monitors 
DEC #: DEC-T9-MTZB-D 
Location of Error: Chapter 4 

Page 392 



H. f. *£ '**- 



Lon 4. 



.5 Testing for a sharable high segment. 

Occasionally it is desirable for a program to find out whether its 
high segment is sharable or not. The program may decide not to 
modify itself, if it is sharable. The following code will work 
whether or not the system has a high segment capability or not, 
whether the job has a high segment or not: 



HRROI T, 14 ;SEE IF OUR HI-SEG IS SHARABLE 
GETTAB T, ;LOOK AT MONITOR JBTSGN TABLE 

JRST .+2 ; TABLE OR UUO NOT PRESENT 
TLNN T, 200000 ;IS SHARABLE BIT ON? 
JRST NOTSHR ;NO, GO AHEAD AND MODIFY 

;YES, DO NOT MODIFY 



Also: 



P. 381 

After "14- JBTSGN" on next line, add: 

Bit 1=1 if job has a high segment and it is sharable. 



Table 4-4 (Cont) 
GETTAB Tables 



Table Numbers 
(RH of AC) 



23 

24 

25 

26 
27 



30 
31 

32 



Table Names 



NUMTAB 

JBTDEV 

STSTBL 

JBTLOC 
CORTAB 



COMTAB 
JBTNM1 

JBTNM2 



33 


JBTCNO 


34 


JBTTMP 


35 


JBTWCH 


36 


JBTSPL 


37 


JBTRTD 


40 


JBTLIM 


41 


QQQTAB 


42 


JBTQ 



Explanation 



Table of GETTAB addresses (GETTAB immediate); 
index by GETTAB table number, see below. 

Device or file structure name of sharable high seg- 
ment. Index by high segment number. 

Two-character SIXBIT names for job queues; index 
by item numbers, see below. 

Reserved for future. 

Physical core allocation. One bit per one K of 
core if system does not include LOCK UUO. Two 
bits per entry if system includes LOCK UUO. A 
non-zero entry indicates core in use. 

Table of SIXBIT names of monitor commands. 

First half of name of user in SIXBIT; index by 
job number. 

Last half of name of user in SIXBIT; index by 
job number. 

Job's charge number; index by job number. 

Job's TMPCOR pointers; index by job number. 

Job's WATCH bits; index by job number. 

Job's spooling control bits; index by job number. 

Job's real-time status word; index by job number. 

Job's time limit in jiffies; index by job number. 

Timesharing scheduler's queue headers. 

Timesharing scheduler's queue that job is in; 
index by job number. 



Entries in Table 11 - CNFTBL (Configuration Table) 



Item 


4 
5 
6 
7 
10 



Location 
CONFIG 

CONFIG+4 

SYSDAT 

SYSDAT+1 

SYSTAP 

TIME 



Use 



Name of system in ASCIZ 



Date of system in ASCIZ 

Name of system device (SIXBIT) 
Time of day in jiffies 
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Entries in Table 11 - CNFTBL (Configuration Table) (Cont) 



Item 


Location 


11 


THSDAT 


12 


SYSSIZ 


13 


DEVOPR 


14 


DEVLST 


15 


SEGPTR 


16 


TWOREG 


17 


STATES 



Use 



Today's date (12-bit format) 

Highest location in monitor + 1 

Name of OPR TTY console (SIXBIT) 

LH is start of DDB (device -data -block) chain 

LH=-# of high segments, RH=+ # of JOBS (counting NULL job) 

Non-zero if system has two-register hardware and software 

Location describing feature switches of this system in LH, 

and current state in RH 

Assembled according to MONGEN dialog and S.MAC: 

Bit 0=1 if disk system (FTDISK) 

Bit 1=1 if swap system (FTSWAP) 

Bit 2=1 if LOGIN system (FTLOGIN) 

Bit 3=1 if full duplex software (FTTYSER) 

Bit 4=1 if privilege feature (FTPRV) 

Bit 5=1 if assembled for choice of reentrant or non-reentrant 

software at monitor load time (FT2REL) 
Bit 6=1 if clock is 50 cycle instead of 60 cycle. 
Bits 7-9 type of disk system 

if 0, 4-series disk system 

if 1 , 5-series disk system 
Bit 10=1 if independent programmer numbers between project 

(INDPPN is non-zero) 
Bit 11=1 if image mode on Teletype (8-bit SCNSER) 

Set by the privileged operator command, SCHEDULE: 

Bit 34=1 means no remote LOGINs 

Bit 35=1 means no more LOGINs except from CTY 

20 SERIAL Serial number of PDP-10 processor 

Set by MONGEN dialog 

21 MEMNSP Number of nanoseconds per memory cycle for memory 

system. Used by SYSTAT to compute shuffling time. 

22 PTYCNF PTY parameters for Batch. 

LH = the number of the first invisible Teletype (PTYOFS). 
RH = the number of PTY's in the system configuration (PTYN) . 

23 FREPTR AOBJN word to use bit map in monitor for allocating 

4-word core blocks. 

24 LOCORE LH=0, RH=address in monitor for free 4-word core block 

areas. (This is never changed while monitor runs.) 

25 STBSTR Link to STB chain for remote Batch. 
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Entries in Table 12 - NSWTBL (Nonswapping Data) 
Item Location 



Use 



7 
10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 



23 
24 

25 



CORTAB 

CORTAB+7 

CORMAX 

CORLST 

CORTAL 

SHFWAT 

HOLEF 

UPTIME 

SHFWRD 

STUSER 

HIGHJB 

CLRWRD 

LSTWRD 



MEMSIZ 
PARTOT 

PARSPR 



26 


PARCON 


27 


PARADR 


30 


PARWRD 


31 


PARPC 


32 


EPOCNT 


33 


EPOREC 


34 


MAX MAX 


35 


SYSKTM 


36 


CORMIN 



Obsolete, 
unspecified data 

Size in words of largest legal user job (low seg+high seg) 

Byte pointer to last free block in CORTAB 

Total free+dormant+idle K physical core left 

Job number shuffler has stopped 

Absolute address of job above lowest hole, if no job 

Time system has been up in jiffies 

Total number of words shuffled by system 

Number of job using SYS if not a disk 

Highest job number currently assigned 

Total number of words cleared by CLRCOR 

Total number of clock ticks when null job ran and other 

jobs wanted to but could not because: 

a . Swapped out or on way in or out 

b. Monitor waiting for I/O to stop so it can shuffle or swap 

c. Job being swapped out because of expanding core 
Size of physical memory in words 

Total number of user parity errors (memory) since system 

was loaded. 
Total number of spurious (refer to Paragraph 3.1.1) parity 

errors (memory). 
Total number of multiple parity errors (memory). 
The absolute location of the last user mode memory parity error. 
The contents of the last user mode memory parity error. 
The user PC of the last user mode memory parity error. 
Total number of PDL OVR's at UUO level in exec mode. 
Number of PDL OVR's at UUO level which were recovered 

by assigning extended list. 
Highest legal value of CORMAX. 
Count-down timer for SET KSYS command 
Amount of core guaranteed to be available after locking 
jobs in core. 



Entries in Table 13 - SWPTBL (Swapping Data) 
Item Location 




1 

2 

3 

4 



BIGHOL 
FINISH 

FORCE 

FIT 

VIRTAL 



Use 



Number of K in biggest hole in core 

+Job number of job being swapped out 

-Job number of job being swapped in 

Job being forced to swap out 

Job waiting to be fit into core 

Amount of virtual core left in system in K (initially 

set to number of K of swapping space) 
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Entries in Table 13 - SWPTBL (Swapping Data ) (Cont) 
Item Location 



SWPERC 



Use 



LH-number of swap read or write errors 

RH=error bits (bits 18-21 same as status bits) + number 

of K discarded 



Entries in Table 15 - ODPTBL (Once-Only Disk Parameters) 

Item Location Use 





1 

2 

3 



SWPHGH 
K4SWAP 

PROT 
PROTO 



Unused, contains zero in 5-series monitors. 

K of disk words set aside for swapping on all units 

in active swapping list. 

In-core protect time multiplies size of job in K-l 

In-core protect time added to above result after 

multiply. 



Entries in Table 16 - LVDTBL (Level D Disk Parameters) 
Item Location 



Use 




1 
2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 
15 

16 



MFDPPN 

SYSPPN 

FSFPPN 

HELPPP 

PNTPPN 

SYSPPB 

SYSSTR 

SYSUNI 

SWPUNI 

CORNUM 

STNPRT 

UFDPRT 

MBFNUM 
QUESTR 

CRUPPN 



Project-programmer number for UFDs only (1,1) 
Project-programmer number for device SYS (1,4) 
Project-programmer number for FAILSAFE (1,2) 
Project-programmer number for SYSTAT and HELP (2,5) 
Project-programmer number for PRINTER spooling 
program (3,3) 

LH=address of first PPB block 

RH=address of next PPB block to be scanned 

LH=address of first file structure data block 

RH=unused 

LH=address of data block of first unit in system 

RH=unused 

LH=address of first unit for swapping in system 

RH=unused 

Number of 4-word access blocks for disk systems 

allocated at ONCE - only time. 

Standard file privilege code (057), can be changed by 

installation 

Standard UFD privilege code (775), can be changed by 

installation 

Number of monitor buffers allocated at once-only time (2) 

SIXBIT name of file structure containing 3,3. UFD for 

PRINTR and OPFILE queues. 

UFD used for storing system crashes. 



a. 
b. 
a. 
b. 
a. 
b. 
a. 
b. 



Entries in Table 23 - NUMTAB (GETTAB Immediate) 

This table is useful for a program that uses the SPY UUO for efficiency and needs the core address of 
the monitor tables. 
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The format of each entry is as follows: 



Examples: 



LH = Bits 0-8 = maximum item number in table 
Bits 14-17 = a monitor AC. 

RH = executive-mode address of table (item 0) 



XWD ITEM + JBTMXL, JOBSTS 
XWD ITEM + TTPMXL, TTYTAB 



Entries in Table 25 - STSTBL (Two-character SIXBIT names for job queues) 

WordO 

Bits 0-11 = contain the two SIXBIT character mnemonic of job state code 
Bits 12-23 = contain the two SIXBIT character mnemonic of job state code 1 
Bits 24-35 = contain the two SIXBIT character mnemonic of job state code 2 



Word 1 



Bits 0-11 = contain the mnemonics of job state code 3 
Bits 12-23 = contain the mnemonics of job state code 4 
Bits 24-35 = contain the mnemonics of job state code 5 
etc. 



The job state code for a disk system are as follows: 

RN - one of the run queues 

WS - I/O wait satisfied 

TS - Teletype I/O wait satisfied 

DS - disk I/O wait satisfied 

ST - system tape wait 

AU - disk alter UFD wait 

MQ - disk monitor buffer wait 

DA - disk storage allocation wait 

CB - disk core block scan wait 

DT - DECtape control wait 

DC - data control wait 

MT - magnetic control wait 

CA - core allocation wait (to be locked) 

I/O - I/O wait 

TI - Teletype I/O wait 

DI - disk I/O wait 
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SL 


- 


sleep waif 


NU 


- 


null state 


ST 


- 


stop (tC) state 



These state codes are printed by SYSTAT and MOVEI. 

4.9.3.4 DEVSTS AC, or CALLI AC, 54 - This UUO is a diagnostic UUO used to retrieve the DEVSTS 
word of the device data block for an INITed device. The DEVSTS word is used by a device service rou- 
tine to save the results of a CONI after each interrupt from the device. Devices that use the DEVSTS 
UUO are the following: CDR, CDP, MTA, DTA, PTR, PTP, DSK, LPT, and PLT. 

The call is: 

MOVEI AC, channel number of device 

DEVSTS AC, ;or CALLI AC, 54 

error return ;UUO not implemented for any 

;devices 
normal return ;AC contains the DEVSTS 

;word of the DDB. 

Upon return, the contents of the DEVSTS word is returned in AC. Therefore, if the device service 
routine does not store a CONI, useless information may be returned to user. Note that an error return 
is not indicated if the device service routine does not use the DEVSTS word for its intended purpose. 
Devices with both a control and data interrupt store the controller CONI (MTS, DTS, DSK, DSK2, 
DPC, DPC2). 

The DEVSTS UUO is not meaningful when used in asynchronous buffered I/O mode unless a WAIT UUO 
(see Paragraph 4.10.5.3) is issued first to ensure synchronization of the actual data transferred with 
the device status returned . 

4.9.4 Configuration Information 

4.9.4. 1 CALL AC, [SIXBIT /SWITCH/I or CALLI AC, 20 - This UUO returns the contents of the 
central processor data switches in AC. Caution must be exercised in using the data switches because 
they are not an allocated resource and are always available to all users. 

4.9.4.2 CALL AC, [SIXBIT /DEVCHR/1 or CALLI AC, 4 - This UUO allows the user to determine 
the physical characteristics associated with a device name. When the UUO is called, AC must 
contain either 1) the logical or physical device name as a left-iustified SIXBIT quantity, or 2) the 
channel number of the device as a right-justified quantity. 
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The call is: 



MOVE AC, [SIXBIT/DEV/1 
CALL AC, [SIXBIT/DEVCHR/I 
return 



;or MOVEI AC, channel number of device 
;or CALLI AC,4 



If the device is not found, the contents of AC is zero on return. If the device is found, the following 
information is returned in AC. 



Bit 



Bit = 1 



Bit 1 = 


1 


Bit 2 = 


1 


Bit 3 = 


1 


Bit 4 = 


1 


Bit 5 = 


I 


Bit 6 = 


1 


Bit 7 = 


I 


Bit 8 = 


1 


Bit 9 = 


1 


Bit 10 = 


= 1 


Bit 11 = 


= 1 


Bit 12 = 


= 1 


Bit 13 = 


1 


Bit 14 = 


1 


Bit 15 = 


1 


Bit 16 = 


i 


Bit 17 = 


1 


Bit 18 = 


1 


Bit 19 = 


1 


Remain! 


ng 


bits 





Explanation 



DECtape directory is in core. This bit is cleared by an ASSIGN 
or DEASSIGN to that unit. 

Device is a file structure. 

Device is a card reader or cardpunch. 

Device is a line printer. 

TTY is attached to a job . 

TTY is in use as a user console (even if detached). 

TTY is in use as an I/O device. 

Device is a display. 

Device has a long dispatch table (that is, UUOs other than INPUT 
OUTPUT, CLOSE, and RELEASE perform real actions). 

Device is a paper-tape punch. 

Device is a paper-tape reader. 

Device is a DECtape. 

Device is available to this Job or is already assigned to this fob. 

Device is a magnetic tape. 

Device is a TTY. 

Device has a directory (DTA or DSK). 

Device can perform input. 

Device can perform output. 

Device is assigned by a console command. 

Device is assigned by program (INIT). 

If bit 35-n contains a 1, then mode n is legal for that device. 
The mode number (0 through 17) must be converted to decimal 
(e.g., mode 17s is represented by bit 35-15 10 or bit 20). 
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4.9.4.3 CALL AC, CSIXBIT/DEVPPN/] or CALLI AC, 55 - This UUO allows a user program to 
obtain the project-programmer number associated with a device name. 



The call is: 



MOVE AC, [SIXBIT /DEV/I 
CALL AC, [SIXBIT /DEVPP N/1 
error return 
normal return 



;or CALLI AC, 55 



DEV may be a logical or physical device name or SYS. The error return is taken if: 

a. The UUO is not implemented; therefore, the contents of AC remain the same on return 

b. The device does not exist, therefore, zero is returned in AC. 



If a legal device Is specified, the normal return is given and the project-programmer number of either 
the user's directory or device SYS is returned in AC. 

The following is an example to read a UFD even if device SYS is specified. 



I 
I 



MOVE I A, 16 

CALL A, [SIXBIT /GETTAB/3 

MOVE A* Cl»«l 1 
MOVEM A*MFDPPN 

MOVE A* DEVICE NAME TYPED BY USER 
MOVEM A*M0DE+1 
CALL A,£SIXBIT /DEVPPN/3 

MOVE I A,0 
MOVEM A,PPN 

OPEN A, MODE 

JRST ERROR 
LOOKUP A,PPN 

JRST ERROR 
INPUT A, 



;get MFD project-programmer number 

;no change if no GETTAB 

;in case of level C 

;store MFD directory number 

;store device name for OPEN 

;get project-programmer number 

;implied by the device name 

;not implemented or no such device 

;store project-programmer number 

associated with this device 

;try to assign device 

;not available 

;try to lookup UFD 

;not there 

;read first block UFD 



MODE! 


14 



XWD 0,INBUF 


PPN: 
MFDPPN: 




SIXBIT /UFD/ 



XWD lil 



;mode is binary 
;device name 
; buffer headers 
;d?rectory names 
• t extension 

;lookup UFD in MFD 
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4.9.4.4 CALL AC, [SIXBIT /DSKCHK/J or CALLI AC, 45 - The disk characteristics UUO provides 
necessary information for allocating storage efficiently on different types of disks. Most programs ore 
able to use the generic device name DSK rather than special disk names; however, this UUO is needed 
by special monitor support CUSPs. 

This UUO accepts, as arguments, names of file structures (e.g. , DSKA), types of controllers (e.g. , 
DP) controllers (e.g., DPA), logical units (e.g., DSKA3), physical disk units (e.g., DPA3), or 
logical device names (e.g., ALPHA). If the argument in LOC specifies more than one unit, the values 
returned in AC are for the first unit of the specified set. If the argument specifies more than one file 
structure (i.e., DSK or logical device name for disk), the first unit of the first file structure is returned. 

The call is: 



MOVE AC, L"XWD+N,LOC] 



CALL AC, [SIXBIT /DSKCHIyO 
error return 
normal return 



;N is the number of locations 
;of arguments and values starting 
;at location LOC 

;or CALLI AC, 45 
;not a disk 



On a normal return, AC contains status information in the left half and configuration information in 
the right half. The left half bits have been chosen so that the normal state is 0. 



Symbol 


Bit 


Explanation 


.UPRHB 


Bit = 1 


The monitor must reread the home block before the next 
operation to ensure that the pack ID is correct. The 
monitor sets this bit when a disk pack goes off-line. 


.UPOFL 


Bit 1 = 1 


The unit is off-line. 


.UPHWP 


Bit 2 = 1 


The unit is write-protected. 


.UPSWP 


Bit 3 = 1 


The unit belongs to a file structure that is write-protected 
by software for this job. 


.UPSAF 


Bit 4 = 1 


The unit belongs to a single-access file structure. 


.UPZMT 


Bit 5 = 1 


The unit belongs to a file structure with a mount count 
that has gone to zero (i.e., no one is using the file 
structure). Available in 5.02 monitors and later models. 


.UPPRF 


Bit 6 = 1 
Bits 7 and 8 


The unit belongs to a private file structure. 




= 11 


The unit is down 




= 10 


No pack is mounted 




= 01 


A pack is being mounted (desired file structure and pack 
ID is already known by the monitor). 




= 00 


A pack is mounted. 



4-42 



Symbol 



.UPMSB 
.UPNNA 

.UNIAWL 



Bit 



Bit 9 = 1 
Bit 10 = 1 

Bit 11 =1 
Bits 12-14 
Bits 15 - 17 

Bits 18-20 



Bits 21 - 26 
= 
= 1 
= 2 
= 3 

Bits 27 - 29 



Bits 30 - 32 



Bits 33 - 35 



Explanation 



The unit has more than one SAT block. 

The unit belongs to a file structure for which the operator 
has requested no new INITs, LOOKUPS, or ENTERs; set 
by privileged STRUUO function. 

The file structure is wri re-protected for all jobs. 

Reserved for future expansion . 

The code identifies which type of argument was passed to 
the monitor in location LOC. 

Data channel number that software believes hardware is 
connected to; first data channel is 0. 

Controller type: f" ^ 

DR (future drum) controller R£10 
FH (Burroughs disk, Bryant drum) controller RC10 
DP (MawOTtBi disk packs) cyntrn""- P P1Q 



MD (Bryant mass disk) controller RA10 

Controller number; first controller of each type starts at 
(e.g., DPA=0, DPB = 1) 

Unit type; a controller-dependent field used to distinguish 
various options of a unit on its controller. 

If bits 21-26 and bits 30-32 then type is 

1 RD10 Burroughs disk on RC10 

RM10B Bryant drum on RC10 
RP01 disk pack on RP10 
RP02 disk pack on RP10 
RB10B dual positioner on RA10 
RB10A single positioner on RA10 

Physical unit number within controller; first unit is 



1 


1 


2 





2 


1 


3 





3 


1 



The user program supplies in location LOC a left-justified, SIXBIT disk name which may be one of the 
following: 

generic disk name 

1 subset of file structures because of file structure abbreviation 

2 file structure name 

3 unit within a file structure 

4 controller class name 

5 controller class 

6 physical disk unit name 






A-sr 



or a logical name for one of the above assigned by the ASSIGN command. 
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On a normal return, the monitor returns values in the following locations 
LOC+1 (.UFTAL) 



LOC+2 (.STTAL) 

LOC+3 (.UNTAL) 
LOC+4 (.STNAM) 
LOC+5 (.UNCHR) 



LOC+6 (.UNBPU) 
LOC+7 (.STMNT) 



LOC+10 (.UNWPS) 

LOC+11 (.UNSPU) 
LOC+1 2 (.UNK4S) 
LOC+1 3 (.STJOB) 



LOC+1 4 (.UNLOG) 
LOC+15 (.UNNAM) 
LOC+16 (.UNHID) 



The number of blocks left of the logged-in job quota before 
the UFD of the job is exhausted on the unit specified in LOC. 
If negative, the UFD is overdrawn. If the negative number is 
400000 000000, the UFD has not been accessed since LOGIN; 
therefore, the monitor does not know the quota. 

The number of blocks on a first-come first-served basis left for 
all users on the file structure. 

The number of blocks left for all users on the specified unit. 

The file structure name to which this unit belongs. 

a. Bits 0-8 are the number of blocks/cluster. 

b. Bits 9-17 are the number of blocks/track. 

c. Bits 18-35 are the number of blocks/cylinder (see 
Appendix H). 

The number of 128-word blocks on the specified unit. 

The mount count is the number of jobs that have done a 
MOUNT command for this file structure without executing 
a REMOVE command; it is a use count (available in 5.02 
monitors and later monitors). 

The number of words containing data bits per SAT block on 
this unit. 

Number of SAT blocks per unit. 

Number of K allocated for swapping. 

Zero if none or more than one job has this file structure 
mounted. XWD -l,,n if only job n has file structure mounted 
but it is not single access. XWD 0, ,n if job n has file 
structure mounted and it is single access. 

The unit's logical name (e.g., DSKB0). 

The unit's physical name (e.g., DPA0). 

The unit's ID (e.g., 2PR003). 



4.9.4.5 DEVTYP AC, or CALLI AC ,53 - The device-type UUO is used to determine properties of 
devices. This UUO accepts, as an argument, a device name in SIXBIT or a right-justified channel 
number. The call is: 



MOVE AC, [SIXBIT/dev/] 
DEVTYP AC, 
error return 
normal return 



;or MOVEI AC, channel no. 
;or CALLI AC,53 



The error return is given if the UUO is not implemented. On a normal return, if AC=0, the specified 
device does not exist. If the device exists, the following information is returned in AC. 
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Symbol 


Bit 


Explanation 


.TYMAN 


Bit = 1 


LOOKUP/ENTER mandatory. 




Bits 1-11 


Reserved for the future. 


.TYAVL 


Bit 12 = 1 


Device is available to this job. 


-TYSPL 


Bit 13 = 1 


Spooled on disk. (Other. bits reflect 
properties of real device, except variable 
buffer size.) 


.TYINT 


Bit 14 = 1 


Interactive device (output after each break 
character) . 


.TYVAR 


Bit 15 = 1 


Capable of variable buffer size (user can 
set his own buffer lengths). 


.TYIN 


Bit 16 = 1 


Capable of input. 


• TYOUT 


Bit 17 = 1 


Capable of output. 




Bits 18-26 


Job number that currently has device 
INITed or ASSlGNed. 




Bits 27-29 


Reserved for the future. 




Bits 30-35 


Device-type code. 

Code (.TYDSK) Disk of some sort 
Code 1 (.TYDTA) DECtape 
Code 2 (.TYMTA) Magnetic tape 
Code 3 (.TYTTY) TTY or equivalent 
Code 4 ( . TYPTR) Paper-tape reader 
Code 5 (.TYPTP) Paper-tape punch 
Code 6 (.TYDIS) Display 
Code7(.TYLPT) Line printer 
Code 10 (.TYCDR) Card reader 
Code 1 1 (.TYCDP) Card punch 
Code 12 (.TYPTY) Pseudo- Teletype 
Code 13 (.TYPLT) Plotter 
Code 14-57 Reserved for Digital 
Code 60-77 Reserved for customer 



4.9.4.6 DEVSIZ AC, or CALLI AC,101 - This UUO is used to determine the buffer size for a device 
if the user wants to allocate core himself. The call is: 



MOVE AC, [EXP LOC] 
DEVSIZ AC, 
error return 
normal return 

LOC: EXP STATUS 
LOC+1: SIXBIT/dev/ 



;or CALLI AC,101 



;first word of the OPEN block 
;second word of the OPEN block 



rThe error return is given if the UUO is not implemented. On a normal return, AC contains one of the 
following values: 
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If the mode is illegal , AC contains -2 

If the device does not exist, AC contains -I 

If the device exists, but its data mode is dump mode, 
AC contains 0. 

If the device exists and the data mode is legal , AC contains 
in bits 0-17 the default number of buffers, and in bits 18-35 
the default buffer size. 

4.9.4.7 SYSSTR AC, or CALLI AC, 44 - This UUO provides a simple mechanism to obtain all the Hie 
structure names in the system. The proper technique *o access all files in all UR>s is to access the 
MFD on each file structure separately. Monitor support CUSPs use this UUO to access all the files in 
the system . 

The call is: 

MOVEI AC, or the last value returned by previous SYSSTR 
SYSSTR AC, ;or CALLI AC, 46 

error return 
normal return 

An error return is given if either 

a. The UUO is not implemented 

b. The argument is not a file structure name 

On a normal return, the next public or private file structure name in the system Is returned in AC. A 
return of in AC on a normal return means that the list of file structure names has been exhausted. If 
is specified as an argument, the first file structure name Is returned in AC. The argument cannot be 
a physical disk unit name or a logical name. 
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4.9.4.8 SYSPHY AC, or CALLI AC, 51 -This UUO returns all physical disk units in the system. 
This SYSPHY UUO is similar to the SYSSTR UUO (see Paragraph 4.9.4.5). 

The call is: 

MOVEI AC, or the last unit name returned by previous SYSPHY 
SYSPHY AC, ; or CALLI AC , 51 

error return ;not implemented or not a physical disk 

normal return ;unit name 

On the first call AC should be to request the return of the first physical unit name. On subsequent 
calls, AC should contain the previously returned unit name. 

An error return is given if AC does not contain a physical disk unit name or zero. On a normal return, 
the next physical unit name in the system is returned in AC. A return of in AC indicates that the 
list of physical units has been exhausted. 

4.10 I/O PROGRAMMING 

All user mode I/O programming is controlled by monitor programmed operators. I/O is directed by 

a. Associating a device and a ring of buffers with one of the user's I/O channels (INIT, 
OPEN) 

b. Optionally selecting a file (LOOKUP, ENTER) 

c. Passing buffers of data to or from the user program (IN, INPUT, OUT, OUTPUT). 

Device specification may be delayed from program -gene ration time until program-run time since the 
monitor 

a. Allows a logical device name to be associated with a physical device (ASSIGN 
command) 

b. Treats operations that are not pertinent to a given device as no-operation code. 

For example: a rewind directed to a line printer does nothing, and file selection operations for devices 
without a filename directory are always successful. 

4.10.1 I/O Organization 

4. 10. 1 . 1 Files - A file is an ordered set of data on a peripheral device. The extent of a file on input 
is determined by an end-of-file condition dependent on the device. For example: a file is terminated 
by reading an end-of-file gap from mganetic tape, by an end-of-file card from a card reader, or by 
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depressing the end-of-file switch on a card reader (refer to Chapter 5). The extent of a file on output 
is determined by the amount of information written by the OUT or OUTPUT programmed operators up 
through and including the next CLOSE or RELEAS operator. 

4. 10. 1 .2 Job I/O Initialization - The monitor programmed operator 
CALL [SIXBIT /RESET/I or CALLI 

should normally be the first instruction in each user program. It immediately stops all I/O transmissions 
on all devices without waiting for the devices to become inactive. All device allocations made by the 
INIT and OPEN operators are cleared, and, unless the devices have been assigned by the ASSIGN 
command (refer to Chapter 2), the devices are returned to the monitor facilities pool. The content of 
the left half of JOBSA (program break) is stored in the right half of JOBFF so that the user buffer area 
is reclaimed if the program is restarting. The left half of JOBFF is cleared. Any files that have not 
been closed are deleted on disk. Any older version with the same filename remains. The user-mode 
write-protect bit is automatically set if a high segment exists, whether it is sharable or not; therefore, 
a program cannot inadvertently store into the high segment. 

4.10.2 Device Selection 

For all I/O operations, a specific device must be associated with a software \/0 channel . This speci- 
fication is made by an argument of the INIT or the OPEN programmed operators. The INIT or the 
OPEN programmed operators may specify a device with a logical name that is associated with a partic- 
ular physical device by the ASSIGN monitor command. Some CUSPs, e.g., LOGOUT, require l/O 
to specific physical devices regardless of what logical names have been assigned. Therefore, on an 
OPEN UUO, if the sign bit of word of the OPEN block is 1 , the device name is taken as a physical 
name only, and logical names are not searched. A given device remains associated with a software 
J/O channel until released (refer to Paragraph 4.10.8.1) or until another INIT or OPEN is performed 
for that channel . Devices are separated into two categories: those with no filename directory (refer 
to Chapter 5) and those with at least one filename directory (refer to Chapter 6). 

4.10.2.1 Nondirectory Devices - For nondirectory devices, (e.g., card reader and punch, line 
printer, paper-tape reader and punch, and user console) selection of the device is sufficient to allow 
]/0 operations over the associated software channel . All other file specifiers, if given, are ignored. 
Magnetic tape, a nondirectory device, requires, in addition to the name, that the tape be properly 
positioned. It is advisable to use the programmed operators that select a file, so that a directory 
device may be substituted for a nondirectory device at run time. 
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4.10.2.2 Directory Device - For directory devices, (e.g., DECtope and disk) files are addressable 
by name. If the device has a single file directory (e.g. , DECtape) the device name and filename 
are sufficient information to determine a file. If the device has multiple file directories (e.g., disk) 
the name of the file directory must also be specified. These names are specified as arguments to the 
LOOKUP, ENTER, and RENAME programmed operators. 

4.10.2.3 Device Initialization - The OPEN (operation code 050) and INIT (operation code 041) 
programmed operators initialize a file by specifying a device, Idev, and initial file status, STATUS, 
and the location of the input and output buffer headers. 

OPEN D,SPEC INIT D, STATUS 

error return SIXBIT/ldev/ 

normal return XWD OBUF,IBUF 

! error return 



normal return 



SPEC:EXP STATUS 
SIXBIT/dev/ 
XWD OBUF,IBUF 



Data Channel - OPEN and INIT establish a correspondence between the device, Idev, 
and a 4-bif data channel number, D. Most of the other input/output operators require 
this channel number as an argument. If a device is already assigned to channel D, it is 
release (refer to Paragraph 4.10.8.1). The device name, dev, is either a logical or 
physical name, with logical names taking precedence over physical names (refer to 
ASSIGN command, Chapter 2). If the device, dev, is not the system device SYS and is 
allocated to another job or does not exist, the error return is taken. In nondisk systems, 
if the device is the system device SYS, the [ob is put into a system device wait queue, 
and continues running when SYS becomes available. In disk systems where the system de- 
vice SYS is one or more file structures, control returns immediately. 

Initial File Status - The file status, including the data mode, is set to the value of the 
symbol STATUS. Thereafter, bits are set by the monitor and may be tested and reset by 
the user via monitor programmed operators. Bits 30-35 of the file status are normally set 
by an OPEN or INIT UUO. Refer to Table 4-7 for the file status bits. If the data mode 
is not legal (refer to Chapter 5 and 6) for the specified device, the job is stopped and the 
monitor prints 

ILL DEVICE DATA MODE FOR DEVICE dev AT USER addr, 

where dev is the physical name of the device and addr is the location of the OPEN or INIT 
operator, on the user's console. The console is left in monitor mode. 

Data Modes - Data transmissions are either unbuffered or buffered. (Unbuffered mode is 
sometimes referred to as dump mode.) The mode of transmission is specified by a 4-bit 
argument to the INIT, OPEN, or SETSTS programmed operators. Tables 4-5 and 4-6 sum- 
marize the data modes. 
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Octal Code 




1 

2-7 
10 

11-12 
13 

14 



Mnemonic 



A 
AL 



IB 



Table 4-5 
Buffered Data Modes 



Meaning 



ASCII. 7-bit characters packed left Justified, five characters 
per word. 

ASCII line. Same as 0, except that the buffer is terminated by 
a FORM, VT, LINE-FEED, or ALTMODE character. Differs 
from ASCII on TTY and PRT only 

Unused 

Image. A device dependent mode. The buffer is filled with 
data exactly as supplied by the device. 

Unused . 

Image binary. 36-bit bytes. This mode is similar to binary 
mode, except that no automatic formatting or checksumming is 
done by the monitor. 

Binary. 36-bit byte. This is blocked format consisting of a 
word count, n (the right half of the first data word of the buf- 
fer), followed by n 36-bit data words. Checksum for cards 
and paper tape. 



Table 4-6 
Unbuffered Data Modes 



Octal Code 



15 
16 



17 



Mnemonic 



ID 
DR 



Meaning 



Image dump. A device dependent dump mode. 

Dump as records without core buffering. Data is transmitted 
between any contiguous blocks of core and one or more stand- 
ard length records on the device for each command word in the 
command list. 

Dump one record without core buffering. Data is transmitted 
between any contiguous block of core and exactly one record 
of arbitrary length on the device for each command word in 
the command list. 



Buffer Header - Symbols OBUF and IBUF, if non-zero specify the location of the first word 
of the 3-word buffer ring header block for output and input, respectively. Buffered data 
modes utilize a ring of buffers in the user area and the priority interrupt system to permit 
the user to overlap computation with his data transmission. Core memory in the user's 
area serves as an intermediate buffer between the user's program and the device. The buf- 
fer storage mechanism consists of a 3-word buffer ring header block for bookkeeping and a 
data storage area subdivided into one or more individual buffers linked together to form a 
ring. During input operations, the monitor fills a buffer, makes the buffer available to 
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the user's program, advances to the next buffer in the ring, and fills the buffer if it is 
free. The user's program follows the monitor, emptying the next buffer if it is full, or 
waiting for the next buffer to fill. 

During output operations, the user's program and the monitor exchange roles; the user fills the buffers 
and the monitor empties them. Only the headers that will be used need to be specified. For instance, 
the output header need not be specified, if only input is to be done. Also, data modes 15, 16, and 17 
require no header. If either of the buffer headers or the 3-word block starting at location SPEC lies out- 
side the user's allocated core area, the job is stopped and the monitor prints 

ILLEGAL UUO AT USERaddr 

(addr is the address of the OPEN or INIT operator) on the user's console, leaving the console in monitor 
mode. 

The first and third words of the buffer header are set to zero. The left half of the second word is set up 
with the byte pointer size field in bits 6 through 11 for the selected device-data mode combination. 

If the same device (other than disk) is INITed on two or more channels, the monitor retains only the 
buffer headers mentioned in the last INIT (a specification does not override a previous buffer header 
specification). Other I/O operations to any of the channels involved act on the buffers mentioned in 
the last INIT previous to the I/O operations. 

4.10.3 Ring Buffers 

4.10.3.1 Buffer Structure - The ring buffer (see Figure 4-1) is comprised of a buffer ring header block 
and bufferings. 

a. Buffer Ring Header Block - The location of the 3-word buffer ring header block is specified 
by an argument of the INIT and OPEN operators. Information is stored in the header by 
the monitor in response to user execution of monitor programmed operators. The user's pro- 
gram finds all the information required to fill and empty buffers in the header. Bit posi- 
tion of the first word of the header is a flag, which, if 1, means that no input or output 
has occurred for this ring of buffers. The right half of the first word is the address of the 
second word of the buffer currently used by the user's program. The second word of the 
header contains a byte pointer to the current byte in the current buffer. The byte size is 
determined by the data mode. The third word of the header contains the number of bytes 
remaining in the buffer. A program may not use a single buffer header for both input and 
output, nor may a single buffer ring header be used for more than one I/O function at a 
time. User's cannot use the same buffer ring for simultaneous input and output; only one 
buffer ring is associated with each buffer ring header. 



t 



Buffer headers may not be in the user's ACs; however, the buffer headers may be in location above 
JOBPFI (refer to Table 3-1). 
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BUFFER RING 



BUF 1: 



FILE STATUS 



USE FLAG 



SIZE 



BOOKKEEPING 
WORD 



BUF 2 



WORD COUNT 



DATA 



BUFFER RING 
HFADFR BLOCK 














FILE STATUS 


USE 
BIT 




CURRENT 
BUFFER 




USE FLAG 


SIZE 


BUF 3 


BUF 2; 


BOOKKEEPING 
WORD 


WORD COUNT 


BUFFER POINTER 


BYTE COUNTER 














DATA 





BUF 3: 



FILE STATUS 



USE FLAG SIZE 



BOOKKEEPING 
WORD 



BUF 1 



WORD COUNT 



DATA 



Figure 4-1 User's Ring of Buffers 



Buffer Ring - The buffer ring is established by the INBUF and OUTBUF operators, or, if 
none exists when the first IN, INPUT, OUT, or OUTPUT operator is executed, a 2-buffer 
ring is set up. The effective address of the INBUF and OUTBUF operators specifies the 
number of buffers in the ring. The location of the buffer ring is specified by the contents 
of the right half of JOBFF in the user's job data area . The monitor updates JOBFF to point 
to the first location past the storage area . 

All buffers in the ring are identical in structure. The right half of the first word contains 
the file status when the monitor advances to the next buffer in the ring (see Figure 4-2). 
Bit of the second word of a buffer, the use bit, is a flag that indicates whether the buf- 
fer contains active data. This bit is set to 1 by the monitor when the buffer is full on in- 
put or being emptied on output, and set to when the buffer is empty on output or is being 
filled on input. In other words, if the use bit = 0, the buffer is available to the filler; if 
the use bit = 1, the buffer is available to the emptier. The use bit prevents the monitor 
and the user's program from interfering with each other by attempting to use the same buf- 
fer simultaneously. Buffers are advanced by the UUOs and not by the user's program. The 
use bit in each buffer should never be changed by the user's program except by means of 
the UUOs. Bits 1 through 17 of the second word of the buffer contain the size of the data 
area of the buffer plus 1. The size of this data area depends on the device. The right half 
of the third word of the buffer is reserved for a count of the number of words that actually 
contain data. The left half of this word is reserved for other bookkeeping purposes, de- 
pending on the particular device and the data mode. 
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USE 
BIT 





FILE STATUS 




SIZE OF 
DATA AREA 


ADDRESS OF SECOND 
WORD OF NEXT BUFF- 
ER IN RING 


BOOKKEEPING 


WORDS COUNT, N 


N DATA WORDS 


UNUSED 



FIRST WORD 
SECOND WORD 
THIRD WORD 

DATA AREA 



10-0592 

Figure 4-2 Detailed Diagram of Individual Buffer 



4.10.3.2 Buffer Initialization - Buffer data storage areas may be established by the INBUF and 
OUTBUF programmed operators, or by the first IN, INPUT, OUT, or OUTPUT operator, if none exists 
at that time, or the user may set up his own buffer data storage area . 

a . Monitor Generated Buffers - Each device has an associated standard buffer size (refer to 
Chapters 5 and 6). The monitor programmed operators INBUF D, n (operation code 064) 
and OUTBUF D,n (operation code 065) set up a ring of n standard size buffers associated 
with the input and output buffer headers, respectively, specified by the last OPEN or 
INIT operator on data channel D. If no OPEN or INIT operator has been performed on 
channel D, the monitor stops the [ob and prints 

I/O TO UNASSIGNED CHANNEL AT USER addr 

(addr is the location of the INBUF or OUTBUF operator) on the user's console leaving the 
console in the monitor mode. 

The storage space for the ring is taken from successive locations, beginning with the loca- 
tion specified in the right half of JOBFF. This location is set to the program break, which 
is the first free location above the program area, by RESET. If there is insufficient space 
to set up the ring, the monitor automatically attempts to expand the user's core allocation 
by IK. If this fails, the monitor stops the job and prints 

ADDRESS CHECK FOR DEVICE dev AT USER addr 

(dev is the physical name of the device associated with channel D and addr is the location 
of the INBUF or OUTBUF operator) on the user's console, leaving the console in monitor 
mode. 

This message is also printed when an INBUF (OUTBUF) is attempted if the last INIT or 
OPEN UUO on channel D did not specify an input (output) buffer header. 

The ring is set up by setting the second word of each buffer with a zero use bit, the ap- 
propriate data area size, and the link to the next buffer. The first word of the buffer 
header is set with a 1 in the ring use bit, and the right half contains the address of the 
second word of the first buffer 

b. User Generated Buffers - The following code illustrates an alternative to the use of the 
INBUF programmed operator. Analogous code may replace OUTBUF. This user code op- 
erates similarly to INBUF. SIZE must be set equal to the greatest number of data words 
expected in one physical record. 
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GO: I-NIT b0 

SIXB1T/NTA0/ 
XU'D 0-> MAGBUF 
JRST NOTAVL 

MOVF 0. CXWD 400300, BUF 1 +1 3 



NOVF.M 0> MAGBUF 

MDVF. Bj [POINT B\TSIZ,0 ,353 

hOVFM 0* ^AGBUF+1 
JRST CONTIN 
MAGBUF: BLOCK 3 

BUF1 : 

XkD SIZF+1 ,B!JF2 + 1 



BLOCK SIZF+1 



BUF2: 

XV : D S1ZE + 1 ..BUF3 + 1 
BLOCK SIZE+1 

BUF3: 

XWD SIZE+1 >BUF1 +1 
BLOCK SIZE+1 



INITIALIZE ASCII MODE 
MAGNETIC TAPE UNITO 
INPUT ONLY 

THE 400000 IN THE LEFT HALF 
MEANS THE BUFFER WAS NEVER 
REFERENCED. 

SET UP NON-STANDARD BYTE 
SIZE 

GO BACK TO MAIN SEQUENCE 
SPACE FOR BUFFER RING HEADER 
BUFFER 1, 1ST WORD UNUSED 
LEFT HALF CONTAINS DATA AREA 
SIZE+1, RIGHT HALF HAS 
ADDRESS OF NEXT BUFFER 
SPACE FOR DATA, 1ST WORD 
RECEIVES WORD-COUNT. THUS 
ONE MORE WORD IS RESERVED 
THAN IS REQUIRED FOR DATA 
ALONE 
SECOND BUFFER 



;THIRD BUFFER 

;RIGHT HALF CLOSES THE RING 



4.10.4 File Selection (LOOKUP and ENTER) 

The LOOKUP (operation code 076) and ENTER (operation code 077) programmed operators select a file 
for input and output, respectively. These operators are not necessary for nondirectory devices; however, 
it is good programming practice to always use them so that directory devices may be substituted at run 
time (refer to the ASSIGN command, Chapter 2). The monitor gives the normal return for a LOOKUP 
or ENTER to a non-directory device; therefore, user programs can be coded in a device-independent 
fashion. 

4.10.4.1 The LOOKUP Operator - LOOKUP selects a file for input on channel D. 

LOOKUP D,E 
error return 
normal return 



SIXBIT/file/ 
SIXBIT/ext/ 



filename, 1 to 6 characters, left-justified 
filename extension, to 3 
characters, left-justified 



XWD project number, programmer number 



4-52 



If no device has been associated with channel D by an INIT or OPEN UUO, the monitor stops the job, 
prints 

I/O TO UNASSIGNED CHANNEL AT USER LOC addr 

and returns the user's console to monitor mode. The input side of channel D is closed if not already 
closed. The output side is not affected. 

On DECtape, LOOKUP searches the device directory as specified by an INIT. On disk, the user's file 
directory as specified by the contents of location E+3 is searched. 

If the device is a directory device and the file is found, the normal return is taken and information 
concerning the file is returned In location E+l through E+3. The normal return is always taken if the 
device associated with the channel D does not have a directory. The error return is taken if either the 
file is not found or, the file is found but the user does not have access to it. 

4.10.4.2 The ENTER Operator - ENTER selects a file for output on channel D. 

ENTER D,E 
error return 
normal return 

E: SIXBIT/file/ /filename, 1 through 6 

/characters, left-justified 

SIXBIT/ext/ /filename, extension, 

/through 3 characters, left-justified 

EXP < PROT> B8+EXP< TIME > B3+DATE 

XWD project number, programmer number. 

If no device has been associated with channel D by an INIT or OPEN UUO, the monitor stops the job, 
prints 

I/O TO UNASSIGNED CHANNEL AT USER LOC addr 

and returns the user's console to monitor mode. The output side of channel D is now closed (if it was 
not closed)/ the input side is not affected. On DECtape, ENTER searches the device directory as 
specified by an INIT. On disk, the user's file directory, as specified by the contents of location E+3, 
is searched. 

If the device does not have a directory, the normal return is always taken. On directory devices, if 
the file is found and is not being written or renamed, the file is deleted (the user must have access 
privileges to the file) and the storage space on the device is reclaimed. On DECtape, this deletion 



4-53 



I 



must occur immediately upon ENTER to ensure that space is available for writing the new version of the 
file. On disk, the deletion of the previous version does not occur until output CLOSE time, provided 
bit 30 of aOSE is (refer to Paragraph 4.10,7.7) . Consequently, if the new file is aborted when 
partially written, the old version remains. The normal return is taken, and the monitor makes the file 
entry, and records file information. 



The error return is taken if: 

a . The file is not found (LOOKUP only) 

b. The filename in location E is 

c. The file is found but is being written or renamed (ENTER only) 

d. The user does not have access to the file, as supplied by the file if it exists or by the UFD 
if the file does not exist. 



4.10.4.3 RENAME Operator - The RENAME (operation code 055) programmed operator is used 

a . To alter the filename, filename extension, and file access privileges 

b. To delete a file associated with channel D on a directory device 

RENAME D,E 
error return 
normal return 

E: SIXBIT/File/ filename, 1 to 6 characters 

SIXBIT /ext/ filename extension, to 3 characters 

EXP < PROT> B8-K TIME >B23+DATE 
XWD project number, programmer number 

If no device has been associated with channel D, the monitor stops the job, prints 
I/O TO UNASSIGNED CHANNEL AT USER LOC addr 

and returns the user's console to monitor mode. 
The normal return is given if: 

a. The device specified is a nondirectory device. 

b. If the filename specified in location E is 0, the file is deleted after all read references 
are completed. 

c. If the filename specified in location E and the filename extension specified in the left half 
of location E+l are the same as the current filename and filename extension, the access 
protection bits are set to the contents of bits to 8 of location E+2. 

d. If the filename/filename extension specified differ from the current fi lename/filenome 
extension, a search is made for the specified filename and filename extension. If a match 
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is not found (1) the filename is changed to the filename in location E, (2) the filename 
extension is changed to the filename extension in the left half of location E+1 , (3) the 
access protection bits are changed to the contents of bits 0-8 of location E+2, and (4) 
the access date is unchanged. 



The error return is given if: 

a. No file is selected on channel D. 

b. The specified file is not found. 

c. The file is found, but is being written or renamed. 

d. The file is found but the user does not have the privileges to RENAME the file. 

e. If the filename/filename extension specified differ from the current filename/filename 
extension, a search is made for the specified filename and filename extension. If a match 
if found, the error return is taken. 

Refer to Appendix E for the error codes returned in bits 33-35 of location E+1 . 



Examples 



General Device Initialization 



INIDEV: 

1N1T 3> 14 
SIXBIT/DTA5/ 
XWD OBUFjIBUF 
JRST NOTAVL 

;FROM HERE DOWN IS OPTIONAL DEPENDING ON 
REQUIREMENTS 

MOVE 0j JOBFF 
MOVEM 0- SVJBFF 



INBUF 3*4 
OUTBUF 3>\ 
LOOKUP 3* INNAM 
JRST NOTFND 

ENTER 3> OUTNAME 
JRST N0R00M 





JRST @ INIDEV 


ORUF: 


BLOCK 3 


IBUF: 


BLOCK 3 


INNAM: 


SIXBIT/NAME/ 




SIXBIT/EXT/ 



OUTNAM: 







SIXBIT/NAME/ 

SIXBIT/EXT/ 







;JSR HERE 

;BINARY MODE, CHANNEL 3 
;DEVICE DECTAPE UNIT 5 
;BOTH INPUT AN D OUTPUT 
;WHERE TO GO IF DTA5 IS BUSY 

THE DEVICE AND PROGRAM 



SAVE THE FIRST ADDRESS OF THE BUFFER 

RING IN CASE THE SPACE MUST BE 

RECLAIMED 

SET UP 4 INPUT BUFFERS 

SET UP 1 OUTPUT BUFFER 

INITIALIZE AN INPUT FILE 

WHERE TO GO IF THE INPUT FILENAME IS 

NOT IN THE DIRECTORY 

INITIALIZE AN OUTPUT FILE 

WHERE TO GO IF THERE IS NO ROOM IN 

THE DIRECTORY FOR A NEW FILENAME 

RETURN TO MAIN SEQUENCE 

SPACE FOR OUTPUT BUFFER HEADER 

SPACE FOR INPUT BUFFER HEADER 

FILE NAME 

FILE NAME EXTENSION (OPTIONALLY 0), 

RIGHT HALF WORD RECEIVES THE 

FIRST BLOCK NUMBER 

RECEIVES THE DATE 

UNUSED FOR NONDUMP I/O 

SAME INFORMATION AS IN INNAM 
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4.10.5 Data Transmission 
The- programmed operators 



INPUT D,E and IN D,E 

normal return 
error return 



transmit data from the file selected on channel D to the user's core area. The programmed operators 

OUTPUT D,E and OUT D,E 

normal return 
error return 

transmit data from the user's core area to the file selected on channel D. 

If no OPEN or INIT operator has been performed on channel D, the monitor stops the fob and prints 
I/O TO UNASSIGNED CHANNEL AT USER addr 

(addr is the location of the IN, INPUT, OUT, or OUTPUT programmed operator) on the user's console 
and the console is left in monitor mode. If the device is a multiple-directory device and no file is 
selected on channel D, bit 18 of the file status Is set to 1, and control returns to the user's program. 
Control always returns to the location immediately following an INPUT (operation code 066) and an 
OUTPUT (operation code 067). A check of the file status for end-of-file and error conditions must then 
be made by another programmed operator. Control returns to the location immediately following an IN 
(operation code 056) if no end-of-file or error condition exists (i.e., if bits 18 through 22 of the file 
status are all 0). Control returns to the location immediately following an OUT (operation code 057) 
if no error condition or end-of-tape exists (i .e. , if bits 18 through 21 and bit 25 are all zero). Other- 
wise, control returns to the second Location following the IN or OUT. Note that IN and OUT UUOs 
are the only ones in which the error return is a skip and the normal return is not a skip. 

4.10.5.1 Unbuffered Data Modes - Data modes 15, 16, and 17 utilize a command list to specify areas 
in the user's allocated core to be read or written. The effective address E of the IN, INPUT, OUT, 
and OUTPUT programmed operators point to the first word of the command list. Three types of entries 
may occur in the command list. 

a. IOWD n, loc - Causes n words from loc through loc+n-1 to be transmitted. The next 
command is obtained from the next location following the IOWD. The assembler pseudo- 
op IOWD generates XWD -n, loc-1. 

b. XWD 0, y - Causes the next command to be taken from location y. Referred to as a GOTO 
word. Up to three consecutive GOTO words are allowed in the command list. After three 
consecutive GOTO words, an I/O instruction must be written. 

c. - Terminates the command list. 
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The monitor does not return program control to the user until the command list has been completely 
processed. If an illegal address is encountered while processing the list, the job is stopped and the 
monitor prints 

ADDRESS CHECK AT USER addr 
on the user's console and the console is left in monitor mode. 



Example: Dump Output 

Dump input is similar to dump output. This routine 

DMPINI: 

I N I T > 16 
SIXBIT/MTA2V 

.0 

JRST NOTAVL 
JRST eDMPINI 

DMPOUT: 

OUTPUT 0..OUTLST 

STATZ 0> 740000 
CALLISIXBIT /EXIT/3 
JRST e DMPOUT 

DMPDON: 

CLOSE 0, 

STATZ 0> 740000 

CALLCSIXBIT /EXIT/] 
RELEAS 0, 
JRST @DMPDON 

OUTLST: IOWD BUFSIZ, BUFFER 


BUFFER: BLOCK BUFSIZ 



outputs fixed-length records. 



JSR HERE TO INITIALIZE A FILE 

iCHANNEL 0, DUMP MODE 

MAGNETIC TAPE UNIT 2 

NO RING BUFFERS 

WHERE TO GO IF UNIT 2 IS BUSY 

RETURN 

JSR HERE TO OUTPUT THE OUTPUT AREA 

SPECIFIES DUMP OUTPUT ACCORDING 

TO THE LIST AT OUTLIST 

CHECK ERROR BITS 

QUIT IF AN ERROR OCCURS 

RETURN 

JSR HERE TO WRITE AN END OF FILE 

WRITE THE END OF FILE 

:CHECK FOR ERROR DURING WRITE 

END OF FILE OPERATION 

QUIT IF ERROR OCCURS 

RELINQUISH THE DEVICE 

RETURN 

SPECIFIES DUMPING A NUMBER OF 

WORDS EQUAL TO BUFSIZ, STARTING 

AT LOCATION BUFFER 

SPECIFIES THE END OF THE COMMAND 

LIST 

OUTPUT BUFFER, MUST BE CLEARED 

AND FILLED BY THE MAIN PROGRAM 



4.10.5.2 Buffered Data Modes - In data modes 0, 1, 10, 13, and 14 the effective address E of the 
INPUT, IN, OUTPUT and OUT programmed operators may be used to alter the normal sequence of 
buffer reference. If E is 0, the address of the next buffer is obtained from the right half of the second 
word of the current buffer. If E is non-zero, it is the address of the second word of the next buffer to 
be referenced. The buffer pointed to by E can be in an entirely separate ring from the present buffer. 
Once a new buffer location is established, the following buffers are taken from the ring started at E. 
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a. Input - If no input buffer ring is established when the first INPUT or IN is executed, a 
2-buffer ring is set up (refer to Paragraph 4. 10,3.2). 

Buffered input may be performed synchronously or asynchronously at the option of the user. 
If bit 30 of the file status is 1, each INPUT and IN programmed operator performs the 
following: 

(!) Clears the use bit in the second word of the buffer with an address in the right half of 
the first word of the buffer header, thereby making the buffer available for refilling 
by the monitor. 

(2) Advances to the next buffer by moving the contents of the second word of the current 
buffer to the right half of the first word of the 3-word buffer header. 

(3) Returns control to the user's program if an end-of-file or error condition exists. 
Otherwise, the monitor starts the device, which fills the buffer and stops transmission. 

(4) Computes the number of bytes in the buffer from the number of words in the buffer 
(right half of the first data word of the buffer) and the byte size, and stores the result 
in the third word of the buffer header. 

(5) Sets the position and address fields of the byte pointer in the second word of the buffer 
header, so that the first data byte is obtained by an ILDB instruction. 

(6) Returns control to the user's program. 

Thus, in synchronous mode, the position of a device (e.g., magnetic tape), relative to the 
current data, is easily determined. The asynchronous input mode differs in that once a 
device is started, successive buffers in the ring are filled at the interrupt level without 
stopping transmission until a buffer whose bit is 1 is encountered. Control returns to the 
user's program after the first buffer is filled. The position of the device, relative to the 
data currently being processed by the user's program, depends on the number of buffers in 
the ring and when the device was last stopped. 

Example: General Subroutine to Input One Character 

GETCHR: ;CALLIS JSR GETCHR 

GETNXT: SOSG IBUF+2 ; DECREMENT THE BYTE COUNT 

IN 1 * ;GET NEXT BUFFER FROM MONITOR 

JRST GETOK ; RETURN WHEN BUFFER IS FULL 

;TEST ERROR BITS 

STATZ 1,740000'' ;GO PROCESS ERROR 

JRST inerr ;ASSUME END-OF-FILE 

JRST ineof ;GET CHARACTER FROM BUFFER . 

GETOK: ILDB ACIBUE + 1 ;RETURN IF NOT NULL CHARACTER ' 

jumpn AC,@GETChR ; IGNORE NULL AND GET NEXT CHARACTER 

JRST GETNXT 

b. Output - If no output buffer ring has been established (i.e. , if the first word of the buffer 
header is 0), when the first OUT or OUTPUT is executed, a 2-buffer ring is set up (refer 
to Paragraph 4. 10.3.2). If the ring use bit (bit of the first word of the buffer header) is 
1 , it is set to 0, the current buffer is cleared to all 0s, and the position and address fields 
of the buffer byte pointer (the second word of the buffer header) are set so that the first 



For some devices in ASCII mode, the item count provided is always a multiple of five characters. The 
last word of a buffer may be partially full; therefore, user programs that rely on the item count should 
always ignore null characters. 

Revision 1 Monitors 4_58 January 1971 



byte is properly stored by an IDPB instruction. The byte count (the third word of the 
buffer header) is set to the maximum of bytes that may be stored in the buffer, and control 
is returned to the user's program. Thus, the first OUT or OUTPUT initializes the buffer 
header and the first buffer, but does not result in data transmission. 

If the ring use bit is and the bit 31 of the file status is 0, the number of words in the 
buffer is computed from the address field of the buffer byte pointer (the second word of 
the buffer header) and the buffer pointer (the first word of the buffer header), and the 
result is stored in the right half of the third word of the buffer. If bit 31 of the file 
status is 1 , it is assumed that the user has already set the word count in the right half of 
the first data word. The buffer use bit (bit of the second word of the buffer) is set to 1, 
indicating that the buffer contains data to be transmitted to the device. If the device is 
not currently active (i .e. , not receiving data), it is started . The buffer header is ad- 
vanced to the next buffer by setting the buffer pointer in the first word of the buffer head- 
er. If the buffer use bit of the new buffer is 1, the job is put into a wait state until the 
buffer is emptied at the interrupt level . The buffer is then cleared to 0s, the buffer byte 
pointer and byte count are initialized in the buffer header, and control is returned to the 
user's program. 



Example: General Subroutine to Output One Character 



PUTCHR: 



PUTOK: 



OUTERR: 



SOSG OBUF+2 
OUT 2, 
JRST PUTOK 
JRST PUTOK 
■JRST OUTERR 
IDPB AC^OBUF+1 
JRST@PUTCHR 
GETSTS 2*AC 



CALL IS JSR PUTCHR 

DECREMENT BYTE COUNT 

CALL MONITOR TO EMPTY THIS BUFFER 

RETURN WHEN BUFFER AVAILABLE 

PROCESS OUTPUT ERROR 

STORE THIS CHARACTER 

RETURN TO CALLER 

GET THE ERROR STATUS 



4.10.5.3 Synchronization of Buffered J/O (CALL D, [SIXBIT/WAIT/]) - In some instances, such as 
recovery from transmission errors, it is desirable to delay until a device completes its I/O activities. 
The programmed operators 

CALL D, [SIXBIT /WAIT/1 and CALLI D, 10 

return control to the user's program when all data transfers on channel D have finished. This UUO does 
not wait for a magnetic tape spacing operation, since no data transfer is in progress. An MTAPE D, 
(refer to Paragraph 5.5.3) should be used to wait for spacing and I/O activity to finish on magnetic 
tape. If no device is associated with data channel D, control returns immediately. After the device 
is stopped, the position of the device relative to the data currently being processed by the user's pro- 
gram can be determined by the buffer use bits. 
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4. 10.6 Status Checking and Setting 

The file status is a set of 18 bits (right-half word), which reflects the current state of a file transmission. 
The initial status is a parameter of the INIT and OPEN operators. Thereafter, bits are set by the mon- 
itor, and may be tested and reset by the user via monitor programmed operators. Table 4-7 defines the 
file status bits. All bits, except the end-of-file bit, are set immediately by the monitor as the con- 
ditions occur, rather than being associated with the buffer currently used by the user. However, the 
file status is stored with each buffer so that the user can determine which bufferful produced an error. 
A more thorough description of bits 18 through 29 for each device is given in Chapters 5 and 6. 

| 4. 10.6.1 File Status Checking - The file status (refer to Table 4-7) is retrieved by the GETSTS (oper- 
ation code 062) and tested by the STATZ (operation code 063) and STATO (operation code 061) pro- 
grammed operators. In each case, the accumulator field of the instruction selects a data channel. If 
no device is associated with the specified data channel, the monitor stops the Job and prints 

I/O TO UNASSIGNED CHANNEL AT USERaddr 

(addr is the location of the GETSTS, STATZ, STATO, or SETSTS programmed operator) on the user's 
console and the console is left in monitor mode. 

GETSTS D,E stores the file status of data channel D in the right half and in the left half of location E. 

STATZ D,E skips, if all file status bits selected by the effective address E are 0. 

STATO D,E skips, if any file status bit selected by the effective address E is 1. 

4. 10.6.2 File Status Setting - The initial file status is a parameter of the INIT and OPEN programmed 
operators; however, the file status may be changed by the SETSTS (operation code 060) programmed 
operator. 

SETSTS D,E waits until the device on channel D stops transmitting data and replaces the current file 
status, except bit 23, with the effective address E. If the new data mode, indicated in the right four 
bits of E, is not legal for the device, the job is stopped and the monitor prints 

ILL DEVICE DATA MODE FOR DEVICE dev AT USER addr 

(dev is the physical name of the device and addr is the location of the SETSTS operator) on the user's 
console and the console is left in monitor mode. If the user program changes the data mode, it must 
also change the byte size for the byte pointer in the input buffer header (if any) and the byte size and 
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item count in the output buffer header (if any). The output item count should be changed by using 
the count already placed there by the monitor and dividing or multiplying by the appropriate conver- 
sion factor, rather than assuming the length of a buffer. 



Table 4-7 
File Status Bits 



Bit 



18 
19 

20 
21 

22 

23 

24-29 

30 

31 

32-35 



Meaning 



Improper mode (IOIMPM). Attempt to write on a hardware or software 
write-locked tape or file structure, or a software detected redundancy 
failure occurred. Usually set by monitor. 

Hard device detected error (IODERR), other than hardware checksum, 
parity, or search error. The device is in error rather than the data on 
the medium. However, the data read into core or written on the device 
is probably incorrect. Usually set by monitor. 

Hard data error (IODTER). The data read or written has incorrect parity 
or checksum as detected by hardware (or by software on CDR,PTR). 
Usually set by monitor. 

Block too large (IOBKTL). A block of data from a device is too large to 
fit in a buffer; a block number is too large for the unit the file structure 
(DSK) or unit (DTA) has filled; or the user's quota on the file structure has 
been exceeded. Usually set by monitor. 

End of file (IOEOF). The user program has requested data beyond the last 
record or block, or USET1 has specified a block beyond the last data block 
of the file. Usually set by monitor. 

I/O active (IOACT). The device is actively transmitting or receiving 
data. Always set by monitor. 

Device dependent parameters. Refer to Chapters 5 and 6 and Appendix D 
for detailed information about each device. Usually set by user. 

Synchronous input. Stops the device after each buffer is filled. Usually 
set by user. 

User word count. Forces the monitor to use the word count in the third 
word of the buffer (output only). The monitor normally computes the 
word count from the byte pointer in the buffer header. Usually set by user. 

Data mode. Refer to Tables 4-5 and 4-6. Usually set by user. 



4.10.7 File Termination 

File transmission is terminated by the CLOSE D,N (operation code 070) programmed operator. N is 
usually zero, but individual options may be selected independently to control the effect of the CLOSE. 
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Usually a given channel is OPEN for file transmission in only one direction, and CLOSE has the effect 
of either closing input if INPUTs have been done or closing output if OUTPUTS have been done. How- 
ever, disk and DECfape may have a single channel OPEN for both INPUT and OUTPUT, in which case 
the first two options below are useful . 

4. 10.7. 1 CLOSE D,0 - The output side of channel D is closed (bit 35=0). In unbuffered data modes, 
the effect is to execute a device dependent function. In buffered data modes, if a buffer ring exists, 
the following operations are performed: 

a. All data in the buffers that has not been transmitted to the device is written. 

b. Device dependent functions are performed. 

c. The ring use bit (bit of the first word of the buffer header) is set to 1 indicating that the 
buffer ring is available. 

d. The buffer byte count (the third word of the buffer header) is set to 0. 

e. Control returns to the user program when transmission is complete. 

The input side of channel D is also closed (bit 34=0). The end-of-file flag is always cleared. Further 
action depends on the data mode in unbuffered data modes, the effect is to execute a device dependent 
function. In buffered data modes, if a ring buffer exists, the following operations are performed: 

a. Wait until device is inactive. 

b. The use bit of each buffer (bit of the second word) is cleared indicating that the buffer 
is empty. 

c. The ring use bit of the buffer header (bit of the first word of the buffer header) is set to 1 
indicating that the buffer ring is available. 

d. The buffer byte count (the third word of the buffer header) is set to 0. 

e. Control returns to the user program. 

On output CLOSE, the unwritten blocks at the end of a disk file are automatically deallocated (bit 33=0). 
On input CLOSE, the access date of a disk file is updated (bit 32=0). 

4.10.7.2 CLOSE D,l (Bit 35=1) - The closing of the output side of channel D is suppressed. Other 
actions of CLOSE are unaffected. 

4.10.7.3 CLOSE D,2 (Bit 34=1) - The closing of the input side of channel D is inhibited; other 
actions of CLOSE are unaffected. 
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4. 10.7.4 CLOSE D,4 (Bit 33=l)t - The unwritten blocks at the end of a disk file are not deallocated. 
This capability is provided for users who specifically allocate disk space and wish to retain it. 

4.T0.7.5 CLOSE D,10 (Bit 32=l)t - The updating of the access date on CLOSE input is inhibited. 
This capability is intended for use with FAILSAFE, so that files can be saved on magnetic tape without 
causing the disk copy to appear as if it has been accessed. 

4.10.7.6 CLOSE D, 20 (Bit 31=l)t - The deleting of the NAME block in monitor core on CLOSE input 
is inhibited if a LOOKUP was done without subsequent INPUT. This bit is used by the COMPIL CUSP 

to retain the core block in order to speed up the subsequent access by the CUSP called by COMPIL. 

4.10.7.7 CLOSE D,40 (Bit 30=1) f - The deleting of the original file, if any, is inhibited if an 
ENTER which creates or supersedes was done. The new copy of the file is discarded. This bit is used 
by the Queue Manager to create a file or a unique name and not supersede the original file. 

Any combinations of the above bit settings are legal . 
Example: Terminating a File 



DROPDV: 

CLOSE 3; 



STATZ 3* 740000 
JRST OUTERR 
RELEAS 3. 



I*0VE 0, SVJPFF 
MOVEM 0. J0BFF 



JSR HERE 

WRITE END OF FILE AND TERMINATE 

INPUT 

RECHECK FINAL ERROR BITS 

ERROR DURING CLOSE 

RELINQUISH THE USE OF THE 

DEVICE, WRITE OUT THE DIRECTORY 

;RECLAIM THE BUFFER SPACE 



JRST t DROPDV ;RETURN TQ MAM SEQUENCE 

4. 10.8 Device Termination 

4. 10.8. 1 RELEASE - When all transmission between the user's program and a device is finished, the 
program must relinquish the device by performing a 

RELEASE D, 

RELEASE (operation code 071) returns control immediately, if no device is associated with data chan- 
nel D. Otherwise, both input and output sides of data channel D are CLOSEd and the correspondence 
between channel D and the device, which was established by the INIT or OPEN programmed operators, 
is terminated. If the device is neither associated with another data channel nor assigned by the 
ASSIGN command (refer to Chapter 2), it is returned to the monitor's pool of available facilities. 
Control is returned to the user's program. 

Meaningful with disk files only, ignored with non-disk files. 
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4.10.8.2 REASSIGN - This UUO reassigns a device under program control from the current job to a 
I specified job and clears the directory currently in core, but does not clear the logical name assignment. 

The call is: 

MOVE AC, job number 

MOVE AC+1 CSIXBIT /DEVICE/1 

CALL AC, [SIXBIT /REASSI/I ;or CALLI AC, 21 

return pernor and normal 

If on return the contents of AC = 0, the specified job has not been initialized . If the contents of 

AC+1=0, the device has not been assigned to the new job, the device is a console (controlling) Teletype, 

or the logical name is duplicated or is a physical name in the system. A REASSIGN UUO that specifies 

job deassigns the device. 

4.10.9 Examples 

4. 10.9. 1 File Reading - The following UUO sequence is required to read a file: 

INIT Establishes a file structure channel correspondence (or set 

of file structures-channel correspondence). 

LOOKUP Establishes a file-channel correspondence. Invokes a search 

of the UFD. Returns information from the file system. 

INBUF (Optional) Sets up 1 to N ring buffers in the top of core, 

expand core if necessary. 



INPUT 



Sets up 2-buffer ring if no INBUF was done. 



INPUT Requests buffers of data from the monitor. 

CLOSE Breaks file-channel correspondence. 

RELEASE Brea ks de vi ce -cha nne I correspondence . 

4. 10.9.2 File Writing - The following UUO sequence is required to write a file: 

INIT Forms file structure-channel correspondence (or set of 

file structures-channel correspondence). 

ENTER Forms file-channel correspondence. The monitor creates 

some temporary storage for interlocking and shared access 
purpose for the filename. No directory entry is made. 

OUTPUT 



OUTPUT Passes buffers of data to monitor for transmission to storage 

device. 

CL0SE Completes the action of ENTER. Adds filename to file 

system. Normally returns allocated, but unused, blocks 
to the file system. 

RELEASE Breaks device-channel correspondence. 
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4.10.10 Real-Time Programming 

Refer to Chapter 8 for real-time programming arid the RTTRP and TRPSET UUOs. 
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Chapter 5 
Nondirectory Devices 



This chapter explains the unique features of each standard nondirectory I/O device. Each device accepts the 
programmed operators explained in Chapter 4, unless otherwise indicated. Table 5-1 is a summary of the char- 
acteristics of all nondirectory devices. Buffer sizes are given in octal and include three bookkeeping words. 
The user may determine the physical characteristics associated with a logical device name by calling the 
DEVCHR UUO (refer to Paragraph 4.9.4.2). 









Table 5-1 
Nondirectory De\ 


nces 






Device 


Physical 
Name 


Controller 
Number 


Unit 
Number 


Programmed 
Operators 


Data 
Modes 


Buffer 

Size 

(Octal) 1 " 


Card Punch 


CDP 


- 


CP10A 


OUTPUT, OUT i 


A, AL, IB, B 


35 


Card Reader 


CDR 


- 


CRTOA 
461 (PDP-6) 


INPUT, IN 


A, AL, I, B 


36 


Console 
Teletype 


CTY 




LT33A, LT33B 
LT35A, LT37AC 
626 (PDP-6) 


INPUT, IN 
OUTPUT, OUT ' 


A, AL 


23 


Display 
Line Printer 


DIS 
LPT 


— 


VR30, VP10 
340B, 30 
LP10C 


INPUT, OUTPUT 
OUTPUT 


ID 
A, AL, I 


Dump only 
34 


Magnetic 
Tape 


MTAO, MTAI, 
..., MTA7 


TM10A 
TM10B 
516(PDP-6) 


TU20A, TU20B 
TU30A, TU30B 


INPUT, IN 
OUTPUT, OUT 
MTAPE 


A, AL, I 
IB, B 
DR, D 


203 


Paper-Tape 
Punch 1 

Paper-Tape 
Reader 


PTP 
PTR 


- 


PC09 

761 (PDP-6) 

PC09 
760(PDP-6) 


OUTPUT, OUT 
INPUT, IN 


A, AL, I 
IB, B 

A, AL, I 
IB, B 


43 
43 


Plotter 


~ 


XY10 


XY10A 
XY10B 


OUTPUT, OUT 


A, AL, I 
IB, B 


46 


Buffer sizes are subject to chan 
INBUF or OUTBUF may be em F 


ge and should 
»loyed. 


be calculated rat 


her than assumed h 


y user programs. 


A dummy 
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Table 5-1 (cont) 
Nondirectory Devices 





Device 


Physical 
Number 


Controller 
Number 


Unit 

Number 


Programmed 
Operators 


Data 
Modes 


Buffer 
Size , 
(Octal) 1 " 


1 


Pseudo- 
Teletype 

Teletype 


PTY 

TTYO, TTY1, 
..., TTY177 


DC10 

DC68A 

630(PDP-6) 


LT33A, LT33B 
LT35A, LT37AC 
VT06 


INPUT, IN 
OUTPUT, OUT 

INPUT, IN 
OUTPUT, OUT 
TTCALL 


A, AL 
A, AL 


23 
23 




Buffer sizes are subject to change and should be calculated rather than assumed by user programs. A dummy 
INBUF or OUTBUF may be employed. 



5.1 CARD PUNCH 

The device mnemonic is CDP; the buffer size is dependent on the data mode. 
Data Mode Buffer Size 



A, AL 

I, IB 
B 



23 g (20 g data) words - 80 7-bit ASCII characters 
36- (33_ data) words - 80 12-bit bytes 

o O 

35 (32_ data, 33„ punched) words - 26 data words, 
o o o 

word count and checksum punched. 



5.1.1 Concepts 

The header card is the first card of an ASCII file and identifies the card code used (refer to Table 5-2). 
This card is not punched for data modes other than ASCII. The header card has the same punch in all 
columns. 

The end-of-file (EOF) card is the last card of each output file. This card is punched for all data modes. 
The end-of-file card has the same punch in all columns (e.g., 12-11-0-1-6-7-8-9 in columns 1 through 
80). 

5.1.2 Data Modes 

5.1 .2.1 A (ASCII) - ASCII characters are converted to card codes and punched (up to 80 characters per card). 
Tabs are simulated by punching from 1 to 8 blank columns; form-feeds and carriage returns are ignored. 
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Line-feeds cause a card to be punched. All other nontranslafable ASCII characters cause a question 
mark to be punched. Cards can be split between buffers. Attempting to punch more than 80 columns 
per card causes the error bit IOBKTL (bit 21 of status word) to be set. The CLOSE will punch the last 
partial card and then punch an EOF card. 



Table 5-2 
PDP-10 Card Codes 



CHAR 


PDP-10 


DEC 


DEC 


CHAR 


PDP-10 


DEC 


DEC 


ASCII 


029 


026 


ASCII 


029 


026 


SPACE 


040 






@ 


100 


8-4 


8-4 


I 


041 


11-8-2 


12-8-7 


A 


101 


12-1 


12-1 


ii 


042 


8-7 


0-8-5 


B 


102 


12-2 


12-2 


# 


043 


8-3 


0-8-6 


C 


103 


12-3 


12-3 


$ 


044 


11-8-3 


11-8-3 


D 


104 


12-4 


12-4 


% 


045 


0-8-4 


0-8-7 


E 


105 


12-5 


12-5 


& 


046 


12 


11-8-7 


F 


106 


12-6 


12-6 


i 


047 


8-5 


8-6 


G 


107 


12-7 


12-7 


( 


050 


12-8-5 


0-8-4 


H 


110 


12-8 


12-8 


) 


051 


11-8-5 


12-8-4 


I 


111 


12-9 


12-9 


* 


052 


11-8-4 


11-8-4 


J 


112 


11-1 


11-1 


+ 


053 


12-8-6 


12 


K 


113 


11-2 


11-2 


/ 


054 


0-8-3 


0-8-3 


L 


114 


11-3 


11-3 


- 


055 


11 


11 


M 


115 


11-4 


11-4 




056 


12-8-3 


12-8-3 


N 


116 


11-5 


11-5 


/ 


057 


0-1 


0-1 


O 


117 


11-6 


11-6 





060 








P 


120 


11-7 


11-7 


1 


061 


1 


1 


Q 


121 


11-8 


11-8 


2 


062 


2 


2 


R 


122 


11-9 


11-9 


3 


063 


3 


3 


S 


123 


0-2 


0-2 


4 


064 


4 


4 


T 


124 


0-3 


0-3 


5 


065 


5 


5 


U 


125 


0-4 


0-4 


6 


066 


6 


6 


V 


126 


0-5 


0-5 


7 


067 


7 


7 


w 


127 


0-6 


0-6 


8 


070 


8 


8 


X 


130 


0-7 


0-7 


9 


071 


9 


9 


Y 


131 


0-8 


0-8 
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Table 5-2 (Cont) 
PDP-10 Card Codes 



CHAR 


PDP-10 
ASCII 


DEC 
029 


DEC 
026 


CHAR 


PDP-10 
ASCII 


DEC 
029 


DEC 
026 


: 


072 


8-2 or 
11 -Ot 


11-8-2 
or ll-0t 


Z 


132 


0-9 


0-9 


r 


073 


11-8-6 


0-8-2 


[ 


133 


12-8-2 


11-8-5 


< 


074 


12-8-4 


12-8-6 


\ 


134 


11-8-7 


8-7 


= 


075 


8-6 


8-3 


] 


135 


0-8-2 


12-8-5 


> 


076 


0-8-6 


11-8-6 


t 


136 


12-8-7 


8-5 


? 


077 


0-8-7 or 
12-0 1 


12-8-2 
or 12-Ott 


•*- 


137 


0-8-5 


8-2 


Either 
ttEirher 


is accepted on input, but 11-8-2 or 8-2 is punched, 
is accepted on input, but 12-8-2 or 0-8-7 is punched. 







Cards are normally punched with DEC026 card codes. If bit 29 (octal 100) of the status word is on 
(from INIT, OPEN, or SETSTS), cards are punched with DEC029 codes (see Table 5-2, PDP-10 Card 
Codes). The first card of any file (the header card) indicates the card code used (12-0-2-4-6-8 punch 
in column 1 for DEC029 card codes; 12-2-4-8 punch in column 1 for DEC026 card codes). 

5.1.2.2 AL (ASCII Line) - The same as A mode. 

5.1 .2.3 I (Image) - Up to 26 2/3 data words are punched in columns 1 through 80. The buffer set up 
by the monitor depends on the mode used. Image binary causes exactly one card to be punched for 
each output. The CLOSE punches the last partial card, and then punches an EOF card. 

5.1.2.4 IB (Image Binary) - Same as I. 

5.1.2.5 B (Binary) - Column 1 contains the word count in rows 12-3. A 7-9 punch is in column 1. 
Column 2 contains a checksum as described for the paper-tape reader (refer to Paragraph 5.7. 1 .5); 
columns 3 through 80 contain up to 26 data words, 3 columns per word. Binary causes exactly one 
card to be punched for each output. The CLOSE punches the last partial card, and then punches an 
EOF card. 
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5.1.3 Special Programmed Operator Service 

Following a CLOSE, an EOF card is punched. Both the header card of the file (identifies the card 
code used) and the EOF card are laced (i .e. , all holes are punched) in columns 2 through 80 for easy 
file identification. These laced punches are ignored by the card reader service routine. 

After each interrupt, the card punch stores the results of a CONI in the DEVSTS word of the device 
data block. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user (refer to 
Paragraph 4.9.3.4). 

5.1.4 File Status (Refer to Appendix D) 

The file status of the card punch is shown below. 
Standard Bits 



18 21 24 27 30 33 35 



SET BY USER 



SET 

BY MONITOR 



1S 


21 22 










II 


l l l 


1 









Bit 19 - IODERR 
Bit 21 - IOBKTL 
Bit 23 - IDACT 



Punch error 

Reached end-of-card with data remaining in buffer. 

Device is active. 



18 20 22 24 27 



UNUSED 



nan™ 



Device Dependent Bits 



29 



SET BY USER 



Bit 29 



If 1, punch DEC029 card codes in ASCII mode. 
If 0, punch DEC026 codes. 



5.2 CARD READER 

The card reader device mnemonic is CDR; the buffer size is 36- (33„ data) words. 

8 8 
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5.2.1 Concepts 

A header card is the first card of the file and identifies the card code used. The header card is used 
only when changing from or back to installation standard on ASCII input. The header card must not 
be present with any other data modes; if present, the header card is treated as incorrect format, The 
header card has a 12-2-4-8 in column 1 . 

I An EOF card may have one of three forms: a 12-11-0-1 punched in column 1 , a 6-7-8-9 punched in 
column 1 , or a logical OR of the two punched in column 1 . Columns 2 through 80 are ignored. The 
EOF card has the same effect as the EOF key on the card reader. This key must be depressed or the 
end-of-file card must be present at the end of each input file for all data modes. 

5.2.2 Data Modes 

5.2.2. 1 A (ASCII) - All 80 columns of each card are read and translated to 7-bit ASCII code. Blank 
columns are translated to spaces. At the end of each card a carriage return/line-feed is appended. As 
many complete cards as can fit are placed in the input buffer, but cards are not split between two buf- 
fers. Using the standard-sized buffer, only one card is placed in each buffer. 

Cards are normally translated as DEC026 card codes (refer to PDP-10 System Reference Manual). If a 
card containing a 12-0-2-4-6-8 punch in column 1 is encountered, any following cards are translated 
as DEC029 codes (refer to Table 5-2) until the 029 conversion mode is turned off. The 029 mode is 
turned off either by a RELEASE command or by a card containing a 12-2-4-8 punch in column 1. 
Columns 2 through 80 of both of these cards are ignored. 

5.2.2.2 AL (ASCII Line) - This mode is the same as the A mode. 

5.2.2.3 I (Image) - All 12 punches in all 80 columns are packed into the buffer as 12-bit bytes. The 
first 12-bit byte is column 1 . The last word of the buffer contains columns 79 and 80 as the left and 
middle bytes, respectively. The EOF card and the EOF button are processed as in the A mode. Cards 
are not split between two buffers. 

5.2.2.4 IB (Image Binary) - This mode is the same as I. 

5.2.2.5 B (Binary) - Card column 1 must contain a 7-9 punch to verify that the card is in binary format. 
Column 1 also contains the word count in rows 12 through 3. The absence of the 7-9 punch results in 
setting the IOIMPM (bit 18 of status word) flag in the card reader status word. Card column 2 must cpn- 
tain a 12-bit checksum as described for the paper-tape binary format. Cplumns 3 through 80 contain 
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binary data, 3 columns per word for up to 26 words. Girds are not split between two buffers. The 
EOF card and the EOF button are processed the same as in the A mode. 

5.2.2.6 SI (Super-Image) - Super-image mode (data mode 110) may be initialized by setting bit 29 
of the card reader's IOS word. This mode causes the 36 bits read from the I/O bus to be BLKI'd directly 
to the user's buffer. For this mode, the default size of the input buffer is 81 .q words (80iq data words). 

5.2.3 Special Programmed Operator Service 

The card reader, after each interrupt, stores the results of a CONI in the DEVSTS word in the device 
data block. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user (refer to 
Paragraph 4.9.3.4). 

5.2.4 File Status (Refer to Appendix D) 

The file status of the card reader is shown below. 

Standard Bits 



18 21 24 27 30 33 35 



SET BY USER 



SET 

BY MONITOR 



18 21 24 



■n 



Bit 18 - IOIMPM 7-9 punch absent in column 1 of a presumed binary card. 
The card reader is stopped . 

Bit 19 - IODERR Photocell error, card motion error, data missed. The card 
reader is stopped . 

Bit 20 - IODTER Computed checksum is not equal to checksum read on binary 
card . The card reader is stopped . 

Bit 22 - IOEOF EOF card read or EOF button pressed. 

Bit23-IOACT Device is active. 



21 24 27 30 33 35 



Dill 
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Device-Dependent Bits 



UNUSED 



18 21 24 27 29 30 33 35 



Bit 29 



Super- Image mode. 



5 .3 DISPLAY WITH LIGHT PEN 

The device mnemonic is DIS; there is no buffer because the display uses device-dependent dump mode 
only. 

5.3.1 Data Modes 

For ID (IMAGE DUMP - 25), an arbitrary length in the user area may be displayed on the scope. The 
command list format is as described in Chapter 4 with the addition for the Type 30, VR30 and VP10 
display, that, if RH = 0, and LH / 0, then LH specifies the intensity for the following data (4 to 13). 

5.3.2 Background 

The monitor service routine for the Type 30, VR30 and VP10 maintains a flicker-free picture on the 
display during time -sharing; therefore, the picture data must be available for display at least every 
two jiffies. This time requirement necessitates that the display data remain in core; also, the user 
program must remain in core. To minimize swapping of other programs and to make available a larger 
block of free core for other users, the user program is shuffled toward the top of core between pictures. 

5.3.3 Display UUOs 

The I/O UUOs for both displays operate as follows: 



INITD, 15 

SIXBIT /DIS/ 



ERROR RETURN 

NORMAL RETURN 

CLOSE D, 

or 
RELEAS D, 



MODE 15 ONLY 
DEVICE NAME 
NO BUFFERS USED 
DISPLAY NOT AVAILABLE 

STOPS DISPLAY AND 
RELEASES DEVICE AS 
DESCRIBED IN CHAPTER 4 
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5.3.3.1 INPUT D, ADR - If a light pen hit has been detected since the last INPUT command, then 
C(ADR) is set to the location of last light pen hit. If no light pen hit has been detected since last 
INPUT command, then C(ADR) is set to -1. 

5.3.3.2 OUTPUT D, ADR - ADR specifies the first address of a table of pointers. This table is 
composed of pointers with the following format: 



17)8 



35 



LH 


RH 
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For the Type 30, VR30 and VP10 Display: 

If LH = and RH = 0, then this is the end of the command list. 

If LH /0 and RH = 0, then LH is the desired intensity for the following data or commands. 
The intensity ranges from 4 to 13, where 4 is the dimmest and 13 is 
the brightest. 

If LH = and RH / 0, then RH is the address of the next pointer. Successive pointers are 
interpreted beginning at RH. 

If LH ^0 and RH ^0, then -LH words beginning at address RH + 1 are output as data to 
the display. The format of the data word is the following: 



7 8 



17 18 



25 26 



35 





y- coord 




x-coord 



For the Type 340B Display: 

If RH = 0, then this is the end of the command list. 

If LH = and RH /0, then RH is the address of the next pointer. Successive pointers are 
interpreted beginning at RH. 

If LH 7^0 and RH /0, then -LH words beginning at address RH+1 are output as data to the 
display. The format of the data word is described in the Precision 
Incremental CRT Display Type 340 Maintenance Manual. 

An example of a valid pointer list for the VR-30 display is: 



OUTPUT 


D* LIST 


* OUTPUT DATA 








JP0INTED TO BY LIST 


list; 


XWC 


5. 


^INTENSITY 5 (DIM) 




IOWD 


1 * A 


*PL0T A 




I0WD 


5*SUBP1 


*PLOT SUBPICTURE 1 




XWD 


1 3*0 


INTENSITY 13 (BRIGHT) 




IOWD 


1 *C 


;PLOT C 




IOWD 


2*SUBP2 


*PLOT SUBPICTURE 2 




XWD 


0*LIST1 


* TRANSFER TO LIST 1 


LISTl : 


XWD 


10*0 


* INTENSITY 10 (NORMAL) 




IOWD 


1 *B 


JPLOT B 




IOWD 


1 *D 


5PL0T d 




XWD 


0*0 


*END OF COMMAND LIST 




OUTPUT 


D* LIST 


* OUTPUT DATA 
*POINTED TO BY LIST 


A 




XWD 


6*6 


*Y= 6* X=6 


B 




XWD 


70*105 


*Y= 70* X=105 


C 




XWD 


105*70 


*Y= 105* X=70 


D 




XWD 1000*200 


JY=1000* X=200 


SUBP1 : 


BLOCK 


5 


* SUBPICTURE 1 


St 


JB2: 


BLOCK 


2 


* SUBPICTURE 2 



5-9 



An example of a valid pointer list for the Type 340B Display is: 



LIST: 



LIST1 



OUTPUT 


D, LIST 


IOWD 


1 .A 


IOWD 


5.SUBP1 


IOWD 


1 ..c 


IOWD 


5.SUBP1 


IOWD 


1 ,B 


IOWD 


2.SUBP2 


IOWD 


0.LIST1 



IOWD 



1 ,D 







IOWD 


5>SUBP1 




IOWD 


1 .A 




IOWD 


2..SUBP2 




XWD 


0.>0 


A 




X = 6 


Y = 6 


B 




X = 105 


Y=70 


C 




X=70 


Y=105 


D 




X=1000 


Y=-200 


SUBP1 : 


BLOCK 


5 


SL 


JBP2: 


BLOCK 


2 



joutput data pointed 
jto by pointer in list 

; set starting point to c6*65 

;draw a circle 

jset starting point to < 70 .> 1 5 ) 

;draw a circle 

;set starting point to u05w0) 

;draw a triangle 

TRANSFER TO LISTl 

JSET STARTING POINT TO 

i ( 100,-200) 

iDRAW A CIRCLE 

JSET STARTING POINT TO C6..6) 

iDRAW A TRIANGLE 

S STOP 



;DRAW A CIRCLE 
;DRAW A TRIANGLE 



The example shows the flexibility of this format. The user can display a subpicture by setting up a 
pointer. He can also display the same subpicture in many different places by setting up pointers to the 
subpicture, each preceded by a pointer to commands for the display to reset its coordinates. 

5.3.4 File Status (See Appendix D) 

The file status of the display is shown below. 

Standard Bits 



18 21 24 27 30 33 35 



SET BY USER 



SET BY MONITOR 









ll: 


23 






111 









Bit 23 - IOACT 



Device is active . 



18 21 24 27 30 33 35 



UNUSED 






Device Dependent Bits - None. 



5-10 



5.4 LINE PRINTER 



The device mnemonic is LPT; the buffer size is 34„ (33 Q data) words. 

o o 



5.4.1 Data Modes 

5.4. 1 . 1 A (ASCII) - ASCII characters are transmitted to the line printer exactly as they appear in 
the buffer. Refer to the PDP-10 System Reference Manual for a list of the vertical spacing characters. 

5.4. 1 .2 AL (ASCII Line) - This mode is exactly the same as A and is included for programming con- 
venience. All format control must be performed by the user's program; this includes placing a RETURN, 
LINE-FEED sequence at the end of each line. 

5.4.1.3 I (Image) - This mode is the same as A (ASCII) mode. 

5.4.2 Special Programmed Operator Service 

The first output programmed operator of a file and the CLOSE at the end of a file cause an extra form- 
feed to be printed to keep files separated. 

After each interrupt, the line printer stores the results of a CONI in the DEVSTS word of the device 
data block. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user (refer to 
Paragraph 4.9.3.4). 



5.4.3 File Status (See Appendix D) 

The file status of the line printer is shown below. 

Standard Bits 



18 21 24 27 30 33 35 



SET BY USER 



SET BY MONITOR 



23 



Bit 23 - IOACT 



UNUSED 



Device dependent bits - None. 



Device is active. 
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5.5 MAGNETIC TAPE 

Magnetic tape format is industry compatible, 7- or 9-channel 200, 556, and 800 bits/in. (see 
description below). The device mnemonic is MTAO, MTA1 , . . . , MTA7; the buffer size is 203„ (200 g 
data) words. 

5.5.1 Data Modes 

5.5. 1 . 1 A (ASCII) - Data appears to be written on magnetic tape exactly as It appears in the buffer. 

No processing or checksumming of any kind is performed by the service routine. The parity checking 

of the magnetic tape system is sufficient assurance that the data is correct. Normally, all data, both 

binary and ASCII, is written with odd parity and at 800 bits per inch unless changed by the installation. 

A maximum of 200 o words per record is allowed if the monitor has set up the buffer ring. If the user 
o 

builds his own buffers, he may specify any number of words per record. The word count is not written 
on the tape. If an I/O error occurs or an end-of-tape is reached, reading ahead ceasing on input and 
implied output ceases on output. 

5.5.1.2 AL (ASCII Line) - The mode is the same as A. 

5.5. 1.3 I (Image) - The mode is the same as A, but data consists of 36-bit words. 

5.5.1.4 IB (Image Binary) - The mode is the same as I. 

5.5.1.5 DR (Dump Records) - Standard fixed length records (128 words is the standard unless installa- 
tion standard is changed at MONGEN time) are read into or written from anywhere in the user's core 
area without regard to the standard buffering scheme. Control for read or write operations must be via 
a command list in core memory. The command list format is described in Chapter 4. For input opera- 
tions a new record is read for each word in the command list (except GOTO words); if the record ter- 
minates before the command word is satisfied, the service routine reads the next records. If the com- 
mand word runs out before the record terminates, the remainder of the record is ignored. For each 
output command word, enough standard length records are followed by one short record to exactly 
write all of the words on the tape. If an I/O error occurs or the end-of-tape is reached, no additional 
commands are retrieved from a dump mode command list, and I/O is terminated. 

5.5. 1 .6 D (Dump) - Variable length records are read into or written from anywhere in the user's core 
area without regard to the standard buffering scheme. Control for read or write operations must be via 
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a command list In core memory. The command list format is described in Chapter 4. For input 
operations a new record is read for each word in the command list (except GOTO words); if the record 
terminates before the command word is satisfied, the service routine skips to the next command word. 
If the command word runs out before the record terminates, the remainder of the record is ignored. For 
each output command word, exactly one record is written (refer to Paragraph 4.4. 1 .2 for command 
list format). 

5.5.2 Magnetic Tape Format 

Magnetic tape format can be generally described as unlabelled, industry-compatible format. That is, 
as far as the user is concerned, the tape contains only data records and EOF marks, which signal the 
end of the data set or the end of the file. 

An EOF mark consists of a record containing a 17 Q (for 7-channel tapes) or a 23 (for 9-channel tapes). 

o o 

EOF marks are used in the following manner: 

a. No EOF mark precedes the first file on a magnetic tape. 

b. An EOF mark follows every file. 

c. Two EOF marks follow a file if that file is the last or only file on the tape. 

Files are sequentially written on and read from a magnetic tape. A file consists of an integral number 
of physical records, separated from each other by interrecord gaps (area on tape in which no data is 
written). There may or may not be more than one logical record in each physical record. 

5.5.3 Special Programmed Operator Service 

CLOSE performs a special function for magnetic tape. When an output file is closed (both dump and 
nondump), the I/O service routine automatically writes two EOF marks and backspaces over one of 
them. If another file is opened, the second EOF mark is wiped out leaving one EOF mark between 
files. At the end of the in-use portion of the tape, however, a double EOF character, which is de- 
fined as the logical end of tape, appears. When an input dump file is closed, the I/O service routine 
automatically skips to the next EOF mark. 

After each interrupt, the magnetic tape service routine stores the results of a CONI in the DEVSTS 
word. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user (refer to 
Paragraph 4.9.3.4). 
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A special programmed operator called MTAPE provides for tape manipulation functions such as rewind, 
backspace record, backspace file, and 9-channel tape initialization. The format is 

MTAPE D, FUNCTION 

where D is the device channel on which the magnetic tape unit is initialized. FUNCTION is selected 
according to Table 5-3. 



Table 5-3 
MTAPE Functions 



Function 


Action 





No operation; wait for spacing and I/O to finish. 


1 


Rewind to load point 


11 


Rewind and unload 


7 


Backspace record 


17 


Backspace files; implemented by a series of backspace 




record operations. 


3 


Write EOF 


6 


Skip one record 


13 


Write 3 in. of blank tape 


16 


Skip one file; implemented by a series of skip record 




operations. 


10 


Space to logical end of tape; terminates at either two 




consecutive EOF marks or at the end of first record 




beyond end of tape marker. 


100 


Initialize for Digital -compatible 9-channel 


101 


Initialize for industry-compatible 9-channel tape 


On the 516 Magnetic Tape Control, this function is implemented as such, but 
earlier types of transports consider it only as a REWIND function. 


Digital-compatible mode writes (or reads) 36 data bits in five frames of a 9-track 


magnetic tape. It can be any density, any parity, and is not industry compatible. 
This mode is in effect until a RELEAS D, or an MTAPE D, 101 is executed. 


ttt 

Industry-compatible 9-channel mode writes (or reads) 32 data bits per word in four 

frames of a 9-track magtape and ignores the last four bits of a word. It must be 


800 bits/in. density, odd parity. 
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MTAPE waits for the magnetic tape unit to complete the action in progress before performing the 
indicated function, including no operation (0). Bits 18 through 25 of the status word are then cleared, 
the indicated function is initiated, and control is immediately returned to the user's program. It is 
important to remember that when performing buffered input/output, the I/O service routine can be 
reading several blocks ahead of the user's program. MTAPE affects only the physical position of the 
tape and does not change the data that has already been read into the buffers. 

5.5.3. 1 Use of the MTAPE Operator - MTAPE functions must be followed by MTAPE if subsequent 
operations depend on the completion of the MTAPE function. If this is not done, subsequent input and 
output UUOs are ignored until the magnetic tape control is freed. This problem occurs frequently in 
programs that issue a REWIND at the beginning of the program. The tape may actually be positioned 
at the beginning of the tape; however, the processing of the MTAPE function may cause the first input 
to be ignored. 

Issuing a backspace file command to a magnetic tape unit moves the tape in the reverse direction until 
the tape has: 

a. passed the end of file mark 

b. reached the beginning of the tape. 

The end of the backspace file operation positions the tape heads either immediately in front of a file 
mark or at the beginning of the tape. 

In most cases it Is desirable to skip forward over this file mark. This is decidedly not the case if the 
beginning of the tape is reached; in this case giving a skip file command would, indeed, skip the entire 
first file on the tape stopping at the beginning of the second file, rather than leaving the tape posi- 
tioned at the beginning of the first file. Therefore, a typical (incorrect) sequence for backspace file 
would be: 

MTAPE MT^-17 ;Backspace file 

CALLI MT.WAIT ;Wait for completion 

STATO MT..4000 ;Beginning of tape? 

MTAPE MT*16 ;No, skip over file mark 

It is necessary to wait after the backspace file instruction to ensure that the tape is moved to the EOF 
mark or the beginning of the tape before testing to see whether or not it is the beginning of the tape. 
The instruction CALLI MT, WAIT cannot be used for this purpose; it waits only for the completion of 
I/O transfer operation. (Backspace file is a spacing operation, not an I/O transfer operation.) Instead, 
use the following sequence for backspace file: 
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MTAPE MT^17 ; Backspace file 

MTAPE MT^0 ;Wa it for completion 

STATO MT..4000 ;Beginning of tape ? 

MTAPE KT.16 ;No, skip over file mark 

The device service routine must wait until the magnetic tape control is free before processing the 
MTAPE MT, command, which tells the tape control to do nothing. Thus, the service routine achieves 
the waiting period necessary for the completion of the previous operation and the proper positioning of 
the tape. 

5.5.4 9-Channel Magtape 

Nine-channel magtape may be written and read in two ways: normal Digital-compatible format, and 
industry-compatible format. 

5.5.4.1 Digital -Compatible Mode - Digital-compatible mode, the usual mode, allows old 7-channel 
user mode programs to read and write 9-channel tapes with no modification. Digital-compatible mode 
writes 36 data bits in five bytes of a nine track magtape. It can be any density, and parity, and is not 
industry compatible. The software mode is specified in the usual manner during initialization or with 
a SETSTS. User mode I/O is handled precisely as 7-track magtape. It is assumed that most DEC 
magtapes will be written and read in Digital-compatible mode. 









Data 


Word 


on 


Tape 
















Trac 


ks 










9 8 


7 


6 




5 




4 


3 


2 


1 


BO Bl 


B2 


B3 




B4 




B5 


B6 


B7 


P 


B8 B9 


BIO 


Bll 




B12 




B13 


B14 


B15 


P 


B16 B17 


B18 


B19 




B20 




B21 


B22 


B23 


P 


B24 B25 


B26 


B27 




B28 




B29 


(B30) 


(B31) 


P 





(B30) 


(B31) 




B32 




B33 


B34 


B35 


P 


P = Parity. 




















BN = Bit N in core. 





















For the data word in core there are 5 magnetic tape bytes per 36-bit word. Parity bits are unavailable 
to the user. Bits are written on tape as shown above; bits 30 and 31 are written twice and tracks 8 and 
9 of byte 5 contain 0. On reading, parity bits and tracks 8 and 9 of byte 5 are ignored, the OR of 
bits (B30) is read into bit 30 of the data word, the OR of bits (B31) is read into bit 31. 
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5.5.4.2 Industry-Compatible Mode - For reading and writing industry-compatible 9-channel magtapes, 
an MTAPE D, 101 UUO must be executed to set the status. MTAPE D, 101 is meaningful for 9-channel 
magtape only and is ignored for all other devices. In the left half of the status word, bit 2 (which 
cannot be read by the user program) may be cleared, thus, the device is returned to 9-channel Digital- 
compatible status by a RELEAS, a call to EXIT, or an MTAPE D, 100 UUO. These MTAPE UUOs act 
only as a switch to and from industry-compatible mode and affect I/O status only by setting the density 
to 800 bits/in. and odd parity. 

On INPUT, four 8-bit bytes are read into each word in the buffer, left justified with the remaining 
four bits of the word containing error checking information. 

On OUTPUT, the leftmost four 8-bit bytes of each word in the buffer are written out in four frames, 
with the remaining four rightmost bits of the word being ignored. 











Data Word on 


Tape 








Tracks 


9 


8 


7 


6 


5 


4 


3 


2 


1 


B0 


Bl 


B2 


B3 


B4 


B5 


B6 


B7 


B32 


B8 


B9 


B10 


Bll 


B12 


B13 


B14 


B15 


B33 


B16 


B17 


B18 


B19 


B20 


B21 


B22 


B23 


B34 


B24 


B25 


B26 


B27 


B28 


B29 


B30 


B31 


B35 



For data word in core, four magnetic tape bytes carry four 8-bit bytes from the data word. Parity bits 
are obtained as shown above when reading. The rightmost four bits (32-35) are ignored on writing. 

5.5.4.3 Changing Modes - MTAPE CH, 101 automatically sets density at 800 bits (i.e., 800 eight- 
bit bytes) per inch and sets odd parity. Note that buffer headers are set up, when necessary by the 
monitor in the usual manner according to the I/O mode in which the device is initialized. Byte 
pointers and byte counts in buffer header have to be changed by the user to operate on eight-bit bytes. 

5.5.5 File Status (refer to Appendix D) 

The file status of the magnetic tape is shown below. 
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Standard Bits 



18 21 24 27 30 33 35 



SET BY USER 








Kllllllllllllll 


I 
T BY MONITOR 


8 


21 24 




l 











Bit 18 - IOIMPM 

Bit 19 - IODERR 
Bit 20 - IODTER 
Bit 21 - IOBKTL 
Bit 22 - IOEOF 

Bit 23 - IOACT 



Unit was write-locked when output was attempted, 
or illegal operation was specified to the magnetic- 
tape control . 

Data was missed, tape is bad, or transport is hung. 

Parity error. 

Record read from tape exceeds buffer size. 

EOF mark encountered. No special character appears 
in buffer. 

Device is active. 



Device Dependent Bits 



18 21 24 26 27 30 33 35 



SET BY USER 



Bit 26 - IOPAR 



Bits 27-28 



Bit 29 - IONRCK 



I/O parity. for odd parity, 1 for even parity. Odd 
parity is preferred. Even parity should be used only 
when creating a tape to be read in binary coded decimal 
(BCD) on another computer. 

I/O density. 00 = System standard. Defined at MONGEN 

time. 
01 = 200 bits/in. 

10 = 556 bits/in. 

11 =800 bits/in. 

I/O no read check. Suppress automatic error correction if 
bit 29 is 1. Normal error correction repeats the desired 
operation 10 times before setting an error status bit. 



18 



21 



24 25 27 



30 



33 



35 



SET BY MONITOR 



Bit 24 - IOBOT 
Bit 25-IOTEND 



I/O beginning of tape. Unit is at beginning of tape mark. 
I/O tape end. Physical end of tape mark encountered. 
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5.6 PAPER- TAPE PUNCH ^ 

The device mnemonic is PTP; the buffer size is 43 (40 data) words. -*..■•* "" i 

5.6.1 Data Modes ^ T / 

5.6.1.1 A (ASCII) - The eighth hole is punched for all characters. Tape-feed without the eighth 
hole (000) is inserted after form-feed. A rubout is inserted after each vertical or horizontal tab. Null 
characters (000) appearing in the buffer are not punched. 



5.6. 1 .2 AL (ASCII) Line - The mode is the same as A mode. Format control must be performed by 
the user's program. 

5.6. 1 .3 I (Image) - Eight-bit characters are punched exactly as they appear in the buffer with no 
additional processing. 

5.6.1.4 IB (Image Binary) - Binary words taken from the output buffer are split into six 6-bit bytes 
and punched with the eighth hole punched in each line. There is no format control or checksumming 
performed by the I/O routine. Data punched in this mode is read back by the paper-tape reader in 
the IB mode. 



5.6.1 .5 B (Binary) - Each bufferful of data is punched as one checksummed binary block as described 
for the paper-tape reader. Several blank lines are punched after each bufferful for visual clarity. 

5.6.2 Special Programmed Operator Service 

The first output programmed operator of a file causes approximately two fanfolds of blank tape to be 
punched as leader. Following a CLOSE, an additional fanfold of blank tape is punched as trailer. No 
EOF character is punched automatically. 

After each interrupt, the paper-tape punch stores the results of a CONI in the DEVSTS word of the 
device data block. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user 
(refer to Paragraph 4.9.3.4). 

5.6.3 File Status (Refer to Appendix D) 

The file status for the paper-tape punch is shown below. 
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Standard Bits 



18 21 24 27 30 33 35 



SET BY USER 



SET BY MONITOR 






23 






Bit 23 - IOACT 



Device is active. 



UNUSED] II || 



Device Dependent Bits - None 

5.7 ER-TAPE READER 

The de. je mnemonic is PTR; the buffer size is 43„ (4CL data) words. 



5.7.1 Data Modes (Input Only) 



NOTE 



To initialize the paper-tape reader, the input tape must 
be threaded through the reading mechanism and the FEED 
button must be depressed. 



5.7.1.1 A (ASCII) - Blank tape (000), RUBOUT (377), and null characters (200) are ignored. All 
other characters are truncated to seven bits and appear in the buffer. The physical end of the paper 
tape serves as an EOF, but does not cause a character to appear in the buffer. 

5.7.1.2 AL (ASCII Line) - Character processing is the same as for the A mode. The buffer is termi- 
nated by LINE FEED, FORM, or VT. 

5.7. 1 .3 I (Image) - There is no character processing. The buffer is packed with 8-bit characters 
exactly as read from the input tape. Physical end of tape is the EOF indication but does not cause a 
character to appear in the buffer. 
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5.7.1.4 IB (Image Binary) - Characters not having the eighth hole punched are ignored. Characters 
are truncated to six bits and packed six to the word without further processing. This mode is useful for 
reading binary tapes having arbitrary blocking format. 

5.7.1.5 B (Binary) - Checksummed binary data is read in the following format. The right half of the 
first word of each physical block contains the number of data words that follow and the left contains 
half a folded checksum. The checksum is formed by adding the data words using 2's complement arith- 
metic, then splitting the sum into three 12-bit bytes and adding these using 1 's complement arithmetic 
to form a 12-bit checksum. The data error status flag (refer to Table 4-7) is raised if the checksum 
miscompares. Because the checksum and word count appear in the input buffer, the maximum block 
length is 40. The byte pointer, however, is initialized so as not to pick up the word count and check- 
sum word. 

Again, physical end of tape is the EOF indication, but does not result In putting a character in the buffer. 

5.7.2 Special Programmed Operator Service 

After each interrupt, the paper-tape reader stores the results of a CONI in the DEVSTS word of the 
device data block. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user 
(refer to Paragraph 4.9.3.4). 

5.7.3 File Status (Refer to Appendix D) 

The file status of the paper-tape reader is shown below. 

Standard Bits 



18 21 24 27 30 33 35 



SET BY USER 



SET BY MONITOR 











1 


IIIIIIIIIIIIIIIIIIIIIIIIIIII 


18 20 22 23 




Ejj( 1 


I I 


1 











Bit 18 
Bit 20 
Bit 22 - IOEOF 

Bit 23 - IOACT 



Binary block is incomplete. 

Bad checksum in binary mode. 

Physical end of tape is encountered. No character 
is stored in the buffer. 

Device is active. 



5-21 



1819 21 



UNUSED 



Device dependent bits - None 



5.8 PLOTTER 



The device mnemonic is PLT; the buffer size is 43„ (40„ data) words. The plotter takes 6-bit characters 
with the bits of each character decoded as follows: 



PEN 
RAISE 


PEN 
LOWER 


-X 

DRUM 

UP 


+ X 
DRUM 
DOWN 


+ Y 

CARRIAGE 

LEFT 


-Y 

CARRIAGE 

RIGHT 



Do not combine PEN RAISE or LOWER with any of the position functions. (For more details on the 
incremental plotter, refer to the PDP-10 System Reference Manual.) 

5.8.1 Data Modes 

5.8. 1 . 1 A (ASCII) - Five 7-bit characters per word are transmitted to the plotter exactly as they 
appear in the buffer. The plotter is a 6-bit device; therefore, the leftmost bit of each character is 
ignored. 

5.8.1.2 AL (ASCII Line) - This mode is identical to the A mode. 

5.8. 1 .3 I (IMAGE) - Six 6-bit characters per word are transmitted to the plotter exactly as they 
appear in the buffer. 

5.8.1.4 B (BINARY) - This mode is identical to the I mode. 

5.8.1.5 IB (IMAGE BINARY) - This mode is identical to the I mode. 

5.8.1.6 DR (DUMP RECORDS) - This mode is not available. 
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5.8.1.7 D (DUMP) - This mode is not available. 

5.8.2 Special Programmed Operator Service 

The first OUTPUT operator causes the plotter pen to be lifted from the paper before any user data is 
sent to the plotter. The CLOSE operator causes the plotter pen to be lifted after all user data is sent 
to the plotter. These two pen-up commands are the only modifications the monitor makes to the user 
output file. 

After each interrupt, the plotter stores the results of a CONI in the DEVSTS word of the device data 
block. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user (refer to 
Paragraph 4.9.3.4). 



5.8.3 File Status (Refer to Appendix D) 
The file status of the plotter is shown below. 

Standard bits 

18 21 24 27 30 33 35 

SET BY USER 



SET BY MONITOR 











23 




I 


J 









Bit 23 - IOACT 



Device is active. 



UNUSED 



Device dependent bits - None 

5.9 TELETYPE 

The device mnemonic is TTYO, TTY1 , . . . , TTY176, TTY177, CTY; the buffer size is 23 g (20 g data) 
words . 

Line number n of the Type 630 Data Communications System, Data Line Scanner DC10, PDP-8 680 Sys- 
tem, or PDP-8/I DC68A System is referred to as TTYn. The console Teletype is CTY. The Timesharing 
monitor automatically gives the logical name TTY to the user's console when a [ob is initialized. 
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Teletype device names are assigned dynamically. For interconsole communication by program, one 
of the two users must type DEASSIGN TTY to make the Teletype available to the other user's program 
as an I/O device. Typing ASSIGN TTYn is the only way to reassign a Teletype that has been de- 
assigned (refer to TALK command, Table 2-2). 

Two Teletype routines are provided: a newer, full-duplex software routine and an older, half-duplex 
software routine. The full-duplex software is recommended. 

With a full-duplex Teletype service, the two functions of a console, typein and typeout, are handled 
independently, and do not need to be handled in the strict sense of output first and the input. For 
example: if two operations are desired from PIP, the request for the second operation can be typed 
before receiving the asterisk after completion of the first. The echo-checking of typed-in characters 
disappears because the keyboard and the printing operations are independent. To stop unwanted out- 
put, a Control O is typed. Also, the command Control C does not stop a program instantly; the Con- 
trol C will be delayed until the program requests input from the keyboard, and then the program will 
be stopped. When a program must be stopped instantly, as when it gets into a loop, Control C typed 
twice stops the program. 

Programs waiting for Teletype output are awakened eight characters before the output buffer is empty, 
causing them to be swapped in sooner and preventing pauses in typing. Programs waiting for Teletype 
input will be awakened ten characters before the input buffer is filled, thus reducing the possibility of 
lost typein . 

5.9.1 Data Modes 

5.9.1.1 Full-Duplex Software A (ASCII) and AL (ASCII Line) 

The input handling of all control characters is as follows. (All are passed to program except as noted 
below.) 

Ignored on input, suppressed on output. 

Echoes as |A; passed to program. 

Complements switch controlling echoing, not passed to 
program. Used on local -copy dataphones and TWX's. 
(No special action with 5.02 monitors and later monitors.) 

003 | C The user's console is switched to monitor mode the next time 

input is requested by the program. Two successive f C's 
cause the console to be immediately switched to monitor mode. 

004 | D (EOT) 004 passed to program. Not echoed, therefore, typing in a 

Control D (EOT) does not cause a full duplex data phone to 
hang up. 

005 fE (WRU) No special action. 
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000 


NULL 


001 


tA 


002 


t B 



006 



TF 



007 
010 



OTT 

012 
013 

014 

015 



016 

017 



020 



t G (Bell) 

f H (Backspace) 



t I (TAB) 

t J (Linefeed) 

f K (Vertical tab) 

t L (Form) 



t M (Carriage 
return) 



fN 

to 



tP 



021 


fQ 


(XON) 


022 


tR 


(TAPE) 


023 


ts 


(XOFF) 


024 


tT 


(NO TAPE) 


025 


tu 





Complements switch controlling translation of lower case 
letters to upper case. Used when lower case input is 
desired to programs. Not sent to program, but program 
can sense the state of this switch by the TTCALL UUO. 
(No special action with 5.02 monitors and later monitors. 

007 passed to program, and is a break character. 

Acts as a RUBOUT, unless either DDT mode or full char- 
acter set mode is true, or the f F switch (or lower case mode 
in 5.02 monitors and later monitors) is on. In these cases, 

010 is sent to the program. 

011 passed to program. Echoed as spaces if f P switch is on. 
(In 5.02 monitors and later, this character is determined by 
the TTY command.) These spaces are not passed to program. 

Break character; no other special action. 

013 passed to program. Echoes as four linefeeds if f P switch 
is on. (In 5.02 monitors and later monitors this character 

is determined by the TTY command.) Is a break character. 
These linefeeds are not passed to program. 

014 passed to program. Echoes as 8 linefeeds if the* P 
switch is on. (In 5.02 monitors and later models, this char- 
acter is determined by the TTY command. Is a break char- 
acter. These linefeeds are not passed to program. 

If Teletype is in paper-tape input mode, 015 is simply passed 
to program; otherwise, 015 supplies a linefeed echo, and is 
passed to program as a CR and LF, and is a break character 
(due to LF). 

No special action. 

Complements output suppression bit allowing user to turn out- 
put on and off. INPUT, IN IT, and OPEN clear the output 
suppression bit. Not passed to program. Echoed as J O 
followed by carriage return-linefeed. 

Does not appear in the input buffer. When switch is off, 
TAB, VT, and FF are echoed normally. When switch is on, 
TAB is converted to spaces, and VT and FF to linefeeds to 
simulate the action indicated. The f P switch should be 
turned on if the user's terminal does not act on TAB, VT, 
and FF. (No special action with 5.02 monitors and later.) 

Starts paper-tape mode, as described above. Passed to 
program . 

No special action. 

Ends paper-tape mode, as described above; is passed to 
program . 

No special action. 

Deletes input line back to last break character. Typed 
back as f U followed by carriage return-linefeed. 
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026 


tv 


027 


fw 


030 


tx 


031 


tY 


032 


tz 



034 


t\ 


035 


t] 


036 


ft 


037 


t- 


040-137 




140-174 





No special action. 

No special action. 

No special action. 

No special action. 

Acts as EOF on Teletype input. Echoes as f Z followed by 
carriage ret urn- linefeed. Is a break character. Appears 
in buffer as 032. 

033 t [ (ESC) The current ASCII altmode, but is translated to 175 before 

being passed to the program, unless in full character set 
mode (bit 20 in I NIT). 175 is the 1963 altmode; echoes 
as a dollar sign; is always a break character. 

No special action. 

No special action. 

No special action. 

No special action. 

Printing characters, no special action. 

Lower case ASCII; translated to upper case, unless 
f F switch (or lower case mode in 5.02 monitors 
and later monitors) is set. Echoes as upper case if 
translated to upper case. 

175 and 176 Old versions of altmode; refer to description of ESC (033). 

177 RUBOUT or DELETE: 

a. Completely ignored if in paper-tape mode (XON). 

b„ Break character, passed to program if either DDTmode 
or full character-set mode is true. 

c. Otherwise (ordinary case) causes a character to be 
deleted for each rubout typed. All the characters 
deleted are echoed between a single pair of back- 
slashes. If no characters remain to be deleted, echoes 
as a carriage return-linefeed. 

On output, all characters are typed just as they appear in the output buffer with the exception of TAB, 
VT, and FORM, which are processed the same as on type-in. Programs should avoid sending f D be- 
cause it may have catastrophic effects (e.g. , it may hang up certain data sets). 



5.9.1.2 Half-Duplex Software A(ASCII) - If, during output operations, an echo-check failure occurs 
(the received character was not the same as the transmitted character), the I/O routine suspends out- 
put until the user types the next character. If that character is fC, the console is immediately placed 
in monitor mode. If it is lO, all Teletype output buffers that are currently full are ignored, thus cut- 
ting the output short. All other characters cause the service routines to continue output. The user may 
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cause a deliberate echo check by typing in while typeout is in progress. For example, to return to 
monitor control mode while typeout is in progress, the user must type any character ("X", for example) 
until an echo check occurs and output is suspended; then he types f C. 

The buffer is terminated when it is full or when the user types f Z. 

5.9.1.3 Half-Duplex Software AL(ASCII Line) - The mode is the same as ASCII mode (usually preferred) 
with the addition that the input is terminated by a CR/LF pair, FF, VT, or ALTMODE. 

| 5.9.1.4 I (Image) - Image mode is legal for Teletype input and output, except for Teletypes controlled 
by pseu do -Teletypes (refer to Paragraph 5.10). 

Since, on input, any sequence of input characters must be allowed, f C and f Z may.not cause their 
usual escape functions. This means that if the user program accepts all characters and does not release 
the Teletype from image mode, no typein will release the user from this state; consequently, the Tele- 
type would effectively become dead to the system. The break character cannot be used to escape from 
this situation, because DClOand the 630 do not detect the break character. To solve this design 
problem, an image input state is defined. If during the image input state, no characters are received 
for 15 seconds, the image input state is terminated by SCNSER (scanner service) and a f C is simulated. 
Therefore, if the user discovers that his program has failed because of this condition, he simply stops 
typing until a T C appears. 

The image input state begins when the program goes into I/O wait because of an INPUT UUO in image 
mode. It ends when the program executes any Teletype output operation. If no output is desired, the 
TTCALL UUO can be executed to output a null string. 

When using image mode input to read binary tapes, echoing should be suppressed by setting bit 28 in 
the Teletype status word. 

NOTE 

Since there are no break characters in image mode, characters 
are transferred a character at a time instead of a line at a 
time. Therefore, an input buffer may only have one character 
in if when control is returned to the user program. 

On output, the low-order eight bits of each word in the user's buffer are outputted. These characters 
are transmitted exactly as supplied by the user. Parity is neither checked nor added, and filler char- 
acters are not generated. Image mode affects buffered output (INIT, OUTPUT UUOs) only, except 
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when allowing output to plotting devices by FORTRAN subroutines. For this case, an additional 
TTCALL function has been added (refer to Paragraph 5.9.3). 

5.9.2 DDT Submode 

To allow a user's program and the DDT debugging program to use the same Teletype without interferring 
with one another, the Teletype service routine provides the DDT submode. This mode does not affect 
the Teletype status if it is initialized with the INIT operator. It is not necessary to use INIT to perform 
I/O in the DDT submode. I/O in DDT mode is always to the user's Teletype and not to any other 
device. 

In the DDT submode, the user's program is responsible for its own buffering. Input is usually one char- 
acter at a time, but if the typist types characters faster than they are processed, the Teletype service 
routine supplies buffers full of characters at the same time. 

To input characters in DDT mode, user the sequence 

MOVEI ACBUF 

CALL AC* CSIXBIT/DDTIN/] 

BUF is the first address of a 21-word block in the user's area. The DDTIN operator delays, if necessary, 
until one character is typed in. Then all characters (in 7-bit packed format) typed in since the pre- 
vious occurrence of DDTIN are moved to the user's area in locations BUF, BUF+1 . The character string 
is always terminated by a null character (000). RUBOUTs are not processed by the service routine but 
are passed on to the user. The special control characters f O and f U have no effect. Other charac- 
ters are processed as in ASCII mode. 

To perform output in DDT mode, use the sequence 

MOVEI ACBUF 

CALL ACCSIXBIT /DDTOUT/3 

BUF Is the first address of a string of packed 7-bit characters terminated by a null (000) character. The 
Teletype service routine delays until the previous DDTOUT operation is complete, then moves the en- 
tire character string into the monitor, begins outputting the string, and restarts the user's program. 
Character processing is the same as for ASCII mode output. 

5.9.3 Special Programmed Operator Service 

The general form of the TTCALL (operation code 051) programmed operator is as follows: 
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TTCALLAC, ADR 

The AC field describes the particular function desired, and the argument (if any) is contained in ADR. 
ADR may be an AC or any address in the low segment above the JOB DATA AREA (137). It may be in 
high segment for AC fields 1 and 3. The functions are: 



AC Field 


Mnemonic' 


Action 





INCHRW 


Input character and wait 


1 


OUTCHR 


Output a character 


2 


INCHRS 


Input character and skip 


3 


OUTSTR 


Output a string 


4 


INCHWL 


Input character, wait, line mode 


5 


INCHSL 


Input character, skip, line mode 


6 


GETLCH 


Get line characteristics 


7 


SETLCH 


Set line characteristics 


10 


RESCAN 


Reset input stream to command 


11 


CLRBFI 


Clear typein buffer 


12 


CLRBFO 


Clear typeout buffer 


13 


SKPINC 


Skip if a character can be input 


14 


SKPINL 


Skip if a line can be input 


15 


IONEOU 


Output as an image character 


16-17 




(Reserved for expansion) 


The TTCALL mnemonics are defined in a separate MACRO assembler table, 
which is scanned If an undefined OP CODE is found. If the symbol is found 
in the TTCALL table, it is defined as though it had appeared in an appro- 
priate OPDEF statement, for example, 


TYPE: OUTCHRCHARAC 


If OUTCHR is undefined, it will be assembled as though the program con- 
tained the statement 


OPDEF OUTCHR TTCALL 1, 


This facility is available in MACRO V.44 and later. 



5.9.3. 1 INCHRW ADR or TTCALL 0,ADR - This command inputs a character into the low-order seven 
bits of location ADR. If there is no character yet typed, the program waits. 
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I 5.9.3.2 OUTCHR ADR or TTCALL 1, ADR - This command outputs a character to the Teletype from 
location ADR. Only the low order 7 bits of the contents of ADR are used. The remaining bits do not 
need to be zeroes. 

If there is no room in the output buffer, the program waits until room is available. ADR may be in 
high segment. 

I 5.9.3.3 INCHRS ADR or TTCALL 2, ADR - This command is similar to INCHRW, except that it skips 
on a successful return, and does not skip if there is no character in the input buffer; it never puts the 
job into a wait. 

TTCALL 2..ADR 
JRST NONE 
JRST DONE 

] 5.9.3.4 OUTSTR ADR or TTCALL 3, ADR - This command outputs a string of characters in ASCIZ 
format : 

TTCALL 3..MESSAGE 
MESSAGE:ASCIZ /TYPE THIS OUT/ 

ADR may be in high segment 

| 5.9.3.5 INCHWL ADR or TTCALL 4, ADR - This command is the same as INCHRW, except that it 
decides whether or not to wait on the basis of lines rather than characters; as such, it is the preferred 
way of inputting characters, because INCHRW causes a swap to occur for each character rather than 
each line (compare DDT and PIP input). 
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Note that a control-C character in the input buffer is sufficient to satisfy the condition of a pendi 
line. Therefore, when the input is done, the control-C is interpreted and the [ob is stopped. This 
definition of a line also applies to TTCALL 5, and TTCALL 14, . 



5.9.3.6 INCHSL or TTCALL 5, ADR - This command is the same as INCHRS, except that its deci- 
sion whether to skip is made on the basis of lines rather than characters. 

| 5.9.3.7 GETLCH ADR or TTCALL 6, ADR - This command takes one argument, from location ADR, and 
returns one word, also in ADR. The argument isa number, representing a Teletype line. If the argu- 
ment is negative, the line number controlling the program is assumed. If the line number is greater than 
those defined in the system, a zero answer is returned. 
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The normal answer format is as follows: 

Right half of ADR: The line number. 

Left half of ADR: Bits, as follows: 

Bit Meaning 

Line is a pseudo-Teletype 

1 Line is the CTY. 

2 Line is the display console. 

3 Line is the dataset data line. 

4 Line is a dataset control line. 

5 Line is half-duplex. 

11 A line has been typed in by the user. 

12 A rubout has been typed. 

13 Lower case input mode is on. 

14 Teletype has tabs. 

15 Teletype input is not echoed. 

16 Control Q (paper-tape) switch is on. 

17 Line is in a talk ring. 

5.9.3.8 SETLCH ADR or TTCALL 7,ADR - 
I the bits described for GETLCH. They may be changed only for the controlling Teletype. Bits 14, 15, 
and 16 can be modified. 

Example: 

SETO AC0 
TTCALL 6> AC 
TLZ ACjBIT 13 
TLO ACjBIT 14 
TTCALL 7jAC 



| 5.9.3.9 RESCAN ADR or TTCALL 10,0 - This command is intended for use only by the COMPIL CUSP. 
It causes the input buffer to be rescanned from the point where the last command began. Obviously, 
if it is executed other than before the first input, that command may no longer be in the buffer. ADR is 
not used, but it is address checked. 
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5.9.3. 10 CLRBFI ADR or TTCALL II ,0 - This command causes the input buffer to be cleared (as if the 
user had typed a number of CONTROL Us. It is intended to be used when an error has been detected 
(e.g. , if a user did not want any commands, which he might have typed ahead, to be executed). 

5.9.3. II CLRBFO ADR or TTCALL 12,0 - This command causes the output buffer to be cleared as if 
the user had typed CONTROL O. It should be used rarely, because usually one wants to see all out- 
put, up to the point of an error. This command is included primarily for completeness. 

5.9.3. 12 SKPINC ADR or TTCALL 13,0 - This command skips if the user has typed at least one char- 
acter. It does not skip if no characters have been typed; however, it never inputs a character. It is 
useful for a computer-based program, which wants to occasionally check for input and, if any, go off 
to another routine (such as FORTRAN Operating System) to actually do the input. 

5.9.3. 13 SKPINL ADR or TTCALL 14,0 - This command is the same as SKPINC, except that a skip 
occurs if the user has typed at least one line. 

5.9.3. 14 IONEOU ADR or TTCALL 15, E - This command outputs the low-order eight bits of the con- 
tents of E as an image character to the terminal. This function is available in 5.02 monitors and later 
monitors. 



5.9.4 File Status (Refer to Appendix D) 

The file status of the Teletype is shown below. 

Standard Bits 

18 21 24 27 30 33 35 



SET BY USER 



SET BY MONITOR 



23 



Bit 23 - IOACT 



Device is active. 
18 22 24 



UNUSED 



28 



inn 
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Device Dependent Bits 



18 21 24 27 28 30 33 35 



SET BY USER 



■ 



Bit 27 
Bit 28 
Bit 29 



Suppresses echoing of ($) on the Teletype. 

Suppresses echoing on the Teletype. 

Full character set. Pass all characters except 
t C with no special character processing. 



SET BY MONITOR 



18 19 


21 24 28 30 33 3 


ill 


111 











Bit 19 
Bit 20 
Bit 21 



Ignore interrupts for three-fourths of a second. 
Echo failure has occurred on output. 
Character was lost on typein. 



5.9.5 Paper-Tape Input from the Teletype (Full-Duplex Software) 

Paper-tape input is possible from a Teletype equipped with a paper-tape reader which is controlled by 
the XON ( t Q) and XOFF ( t S) characters. When commanded by the XON character, the Teletype 
service reads paper tapes, starting and stopping the paper tape as needed and continuing until the 
XOFF character is read or typed in. While in this mode of operation, any RUBOUTS will be discarded 
and no free line feeds will be inserted after carriage returns. Also, TABS and FORMFEEDS will not be 
simulated on a Teletype Model 33, to ensure output of the reader control characters. To use paper 
tape processing, the Teletype with a paper-tape reader must be connected by a full -duplex connection 
and only ASCII paper tapes should be used. 

The correct operating sequence for reading a paper tape in this way is as follows: 



• R PIP^ 
*DSK:FILE«-TTY: tQ^ 

THIS IS WHAT IS ON TAPE 
MORE OF THE SAME 
LAST LINE tz 

* t S 
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5.9.6 Paper-Tape Output at the Teletype (Full-Duplex Software) 

Paper-tape output is possible on any Teletype-mounted paper-tape punch, which is controlled by the 
TAPE (AUX ON) and TAPE (AUX OFF) characters. The punch is connected in parallel with the key- 
board printer, and therefore, when the punch is on, all characters typed on the keyboard are punched 
on tape. 

LT33B or LT33H Teletypes can have the reader and punch turned off and on under program control. 
When commanded by the AUX ON character, the Teletype service punches paper tapes until the AUX 
OFF character is read or typed in. The AUX OFF character is the last character punched on tape. 

When writing programs to output to the Teletype paper-tape punch, the user should punch several inches 
of blank tape before the AUX OFF character is transmitted. This last character may then be torn off 
and discarded. 

5.10 PSEUDO-TELETYPE 

The device mnemonic is PTYO, PTY1 , , PTYn. (The number of pseudo-Teletypes is specified at 

MONGEN time.) The buffer size is 23_ (20 Q data )words. 

o o 

5.10.1 Concepts 

Each job in the PDP-10 timesharing system is usually initiated by a user at a physical terminal. Except 
in the case of a DETACH operation, the job remains under the control of the user's terminal until it is 
terminated by either the KJOB command or the LOGOUT UUO. For each physical Teletype there is a 
block of core in the monitor, containing information about the physical Teletype and including two 
buffers as the link between the physical Teletype and the job. It is through these buffers that the 
Teletype sends input to the job, and the job returns output to the Teletype. 

Sometimes it is desirable to a How a job in the PDP-10 timesharing system to be initiated by a program 
instead of by a user. Since a program cannot use a physical terminal in the way a user can, some 
means must be provided in the monitor for the program to send input to and accept output from the job 
it is controlling. The monitor provides this capability via the pseudo-Teletype (PTY). The PTY is a 
simulated Teletype and is not defined by hardware. Like hardware-defined Teletypes, each PTY has a 
block of core associated with it. This block of core is used by the PTY in the same manner as a hard- 
ware-defined Teletype uses its block of core. Figure 5-1 shows the parallel between a hardware- 
defined Teletype and a software-defined PTY. 
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USER 



CONTROLLING 
PROGRAM 





PHYSICAL 
TELETYPE 


. 1 . 


DEVICE TTY, 

OR 
DEVICE TTYn 






1 

J 




r 




MONITOR 




i 


DEVICE PTY 




DEVICE TTY, 

OR 
DEVICE TTYm 




- r 







CONTROLLED 
JOB 



CONTROLLED 
JOB 



L. 



J 



Figure 5-1 Pseudo-Teletype 

The controlling program, most commonly the batch processor, uses the PTY in the same way as a user 
uses a physical device. It initiates the PTY, inputs characters to and waits for output from the PTY, 
and closes the PTY using the appropriate programmed operators. The job controlled by the program 
performs I/O to the PTY as though the PTY were a physical terminal. 

A controlled job may go into a loop and not accept any input from its associated buffer; therefore, it 
is not possible for the controlling program to simply rely on waiting for activity in the controlled Job. 
A controlling program may also wish to drive more than one controlled job, and be able to respond to 
any of these jobs; therefore, the controlling program cannot wait for any particular PTY. For these 
two reasons, the PTY differs from other devices in that it is never in a I/O wait state. Timing is ac- 
complished by the SLEEP UUO and the status bits of the PTY. 

5.10.2 The SLEEP UUO 

If the controlling program waits for activity in the controlled job, it delays the SLEEP UUO (refer to 
Paragraph 4.3.4.1). When the controlling program continues after a SLEEP UUO, it checks for activity 
on the PTY via the status bits. If there is no activity, it checks the job run time or other criteria to 
determine whether or not the job should be interrupted. If the job should be interrupted, the control- 
ling program may output to the PTY two control-C characters to stop the job. (A user stops a running 
job in the same way.) If the job should not be interrupted, the controlling program should repeat the 
SLEEP UUO. 



Unnecessary delays might result if activity occurred on a PTY while the controlling job was sleeping. 
These delays are avoided because a check is made when a PTY status bit changes to determine if the 
controlling program is in a sleep. If it is, the sleep time is cleared so the controlling program can 
service the PTY. 
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5.10.3 File Status (Refer to Appendix D) 

The file status of the pseu do -Teletype is shown below. 

Standard Bits 

18 21 24 27 30 33 35 



SET BY USER 



SET BY MONITOR 









lllllllllllllllll 


21 23 


111 III 









Bit 21 - IOBKTL 
Bit 23 - IOACT 



Device is active. 



Device Dependent Bits 



18 21 24 27 30 33 35 



SET BY MONITOR 



H 



Bit 24 - IOPTW 



Bit 25 - IOPTRE 



Bit 26 - MONMOD 



Job is in an input wait. The controller performs 
an OUTPUT to the PTY. 

The TTY buffer has output to be read by an 
INPUT from the PTY. 

Any characters typed into the TTY buffer (by 
OUTPUT to the PTY) are read by the monitor 
command decoder instead of by the controlled job. 



5.10.4 Special Programmed Operator Service 

5.10.4.1 OUT, OUTPUT UUOs - The first OUTPUT operation after an INIT or OPEN causes the 
special actions of the RELEASE UUO (refer to Paragraph 5. 10.4.3) and then the following normal 
output operations: 

a . Characters from the controlling program's buffer ring are placed in the input buffer of the 
TTY linked to the PTY. 

b. The IOPTW bit is cleared. 

c. The MONMOD bit is set or cleared as determined by the state of the TTY. 

The following are exceptions to the normal output action: 
a . NULLS (ASCII 000) are discarded. 
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b. If more OUTPUTS are performed than are accepted by the controlled job and if the limit 
on this excess is exceeded, the IOBKTL bit is set and the remainder of the controlling 
program's buffer is discarded. 

c. Lower case characters sent to the controlled job are translated to upper case if the ap- 
propriate bit in the TTY is set. 



5.10.4.2 IN, INPUT UUOs - Characters are read from the output buffer of the TTY and are placed 
in the buffer ring of the controlling program. If there are no characters to read, an empty buffer is 
returned. The INPUT UUO does not cause a WAIT. 

All the available characters are passed to the controlling program . If there are more characters to 
read than can fit in the buffer of the controlling program, the IOPTRE bit remains set and another 
INPUT should be done. If the output buffer of the TTY is exhausted by the INPUT UUO, the IOPTRE 
bit is cleared. 



5.10.4.3 RELEASE UUO - The RELEASE UUO causes the following special actions: 

a . Any characters in the output buffer of TTY are discarded. 

b. If the controlled job is still attached to TTY, it is detached, 

c. The PTY is disassociated from the software channel. 

CAUTION 

Haphazard use of the PTY and subsequent RELEASE opera- 
tions may leave detached jobs tying up core and other sys- 
tem resources. 



5.10.4.4 JOBSTS UUO - This UUO provides status information about device TTY and/or the controlled 
job in order to allow complete and accurate checking of a controlled job. 

The call is: 

MOVEI AC, user channel number ;or MOVNI AC, job number 

JOBSTS AC, ;orCALLIAC, 61 

error return 
normal return 

When the UUO is called, AC contains a number n specifying the job and/or the TTY to be checked. 
If n is from to 17, the specified TTY and job are those currently INITed on the user's channel n. 
If n is negative, the job to be checked is Job number (-n). 
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The error return is given if one of the following is true: 

a. the UUO is not implemented. 

b. n is out of range. 

c. there is no PTY INITed on channel n. 

Otherwise the normal return is given and AC contains the following status information: 



Bit 


Explanation 


Bit = 1 


Job number is assigned . 


Bit 1 = 1 


Job is logged in. 


Bit 2 = 1 


TTY is at monitor level . 


Bit 3 = 1 


TTY output is available. 


Bit 4 = 1 


TTY is at user level and in input wait, or TTY is at 
monitor level and can accept a command. In other 
words, there is no command awaiting decoding or 
being delayed, the job is not running, and the Job 
is not stopped waiting for operator device action. 


Bit 5 = 1 


JACCT is set. In particular, t C t C will not work. 


Bits 18-35 


Job number being checked or if no job number is 
assigned . 



5. 10.4.5 CTLJOB UUO - This UUO is used to determine the job number of the program (job) that 
is controlling the specified job, if any. 



The call is: 



MOVE AC, job number 
CTUOB AC, 
error return 
normal return 



;-l means user's job 
;orCALLIAC, 65 



On a normal return, AC contains the job number of the program (job) that is controlling the controlled 
job. If AC = -1, the specified job is not being controlled via a PTY. 

An error return is given if the UUO is not implemented or the job number is too large. 
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Chapter 6 
Directory Devices 



This chapter explains the unique features of the standard directory devices. Each device accepts the 
programmed operators explained in Chapter 4, unless otherwise indicated. Table 6-1 is a summary of 
the characteristics of the directory devices. Buffer sizes are given in octal and include three book- 
keeping words. The user may determine the physical characteristics associated with a logical device 
name by calling the DEVCHR UUO (refer to Paragraph 4.9.4.2) . 



Table 6-1 
Directory Devices 





Physical 


Controller 


Unit 


Programmed 


Data 


Buffer 


Device 


Name 


Number 


Number 


Operators 


Modes 


Sizes 
(Octal T ) 














DECtape 


DTAO, DTA1, 


TD10 


TU55 


INPUT, IN 


A,AL,I 


202 




...,DTA7 


551(PDP-6) 


555(PDP-6) 


OUTPUT, OUT 
LOOKUP, ENTER 
MTAPE, USETF, 
USETO, USETI 
UTPCLR 


B,IB 
DR, D 




Fixed- 


DSK, FHA, 


RC10 


RD10 


INPUT, IN 


A,AL, I 


203 


Head 


FHAO, ..., 




RM10B 


OUTPUT, OUT 


B, IB 




Disk 


FHA3 






LOOKUP, ENTER 
RENAME, SEEK 
USETO, USETI 


DR, D 




Disk Pack 


DSK, DPA, 


RP10 


RP01 


INPUT, IN 


A,AL,I 


203 




DPAO, ..., 




RP02 


OUTPUT, OUT 


B, IB 






DPA7 






LOOKUP, ENTER 
RENAME, SEEK 
USETO, USETI 


DR, D 




Buffer size 


s are subject to change and should be calculated 


rather than assumed 


Dy user progr 


ams. 


A dummy ' 


NBUF or OUTBUF may be employed. 
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Table 6-1 (Cont) 
Directory Devices 



Device 


Physical 
Name 


Controller 
Number 


Unit 
Number 


Programmed 
Operators 


Data 
Modes 


Buffer 

Sizes 

(Octal') 


Mass-Disk 
File 


MDA 


RA10 


RBI OB 


INPUT,IN 
OUTPUT, OUT 
LOOKUP, ENTER 
RENAME, SEEK 
USETO, USETI 


A, AL, I 

B, IB 

DR, D 


203 


Buffer sizes are subject to change and should be calculated rather than assumed by user programs. 
A dummy INBUF or OUTBUF may be employed. 



6.1 DECTAPE 

The device mnemonic is DTAO, DTA1 , . . ., DTA7; the buffer size is 202 g words (177 g user data, 200 g 
transferred) . 

6.1.1 Data Modes 

Two hundred words are written. The first word is the link plus word count. The following 177 words 
are data supplied to and from user programs. 

6.1.1.1 Buffered Data Modes - Data is written on DECtape exactly as it appears in the buffer and 
consists of 36-bit words. No processing or checksumming of any kind is performed by the service rou- 
tine. The self-checking of the DECtape system is sufficient assurance that the data is correct. Refer 
to Paragraph 6.1 .2 for further information concerning blocking of information. 

6.1 .1 .2 Unbuffered Data Modes - Data is read into or written from anywhere in the user's core area 
without regard to the standard buffering scheme. Conlrol for read or write operations must be via a 
command list in core memory. The command list format is described in Chapter 4. File-structured 
dump mode data is automatically blocked into standard-length DECtape blocks by the DECtape service 
routine. Each block read or written contains 1 link word plus 1 to 177 g data words. Unless the number 
of data words is an exact multiple of the data portion of a DECtape block (177 g ), the remainder of the 
last block written after each OUTPUT programmed operator is wasted. The input programmed operator 
must specify the same number of words that the corresponding output programmed operator specified to 
skip over the wasted fractions of blocks . 
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6.1 .2 DECtape Format 

A standard reel of DECtape consists of 578 (1 102„) prerecorded blocks each capable of storing 128 (200_) 

36-bit words of data. Block numbers that label the blocks for addressing purposes are recorded between 

blocks. These block numbers run from to 1101„. Blocks 0, 1 , and 2 are normally not used during 

timesharing and are reserved for a bootstrap loader. Block 100 ir) (144_) ,s tne directory block, which 

contains the names of all files on the tape and information relating to each file. Blocks 3.-. through 

99> (1-143J and 101 lft through 577. . (145-1 101 o ) are usable for data. 
IU o IU ' IU o 

If, in the process of DECtape I/O, the I/O service routine is requested to use a block number larger 

than 1 101 _ or smaller than 0, the monitor sets the IOBKTL flag (bit 21) in the file status and returns, 
o 

6.1 .3 DECtape Directory Format 

The directory block (block 1 00 . «) of a DECtape contains directory information for all files on that 
tape; a maximum of 22 files can be stored on any one DECtape (see Figure 6-1) . 

The first 83 words (1 through 82. n ) of me directory block contain slots for each of the 577 blocks on a 
DECtape. Each slot occupies five bits (seven slots are stored per word) and represents a given block on 
the DECtape. Each slot contains the number of the file (l-26_) occupying the given block. This 
allows for 581 slots (83 words x 7 slots per word). The four extra slots represent nonexistent blocks 
1 102 through 1105-. The next 22 words of the directory block (words 83 through 104 10 ) contain the 
filenames of the 22 files that reside on the DECtape. Word 83 contains the filename for file 1 , word 
84 contains the filename for file 2. Filenames are stored in SIXBIT code. 

The next 22 words of the directory block (words 105 through 126--.) primarily contain the filename 
extensions and dates of the 22 files that reside on the DECtape, in the same relative order as their 
filenames . The bits for each word are as follows: 

Bits - 17 in The filename extension is SIXBIT code. 

Bits 18 - 23 lf) The number of IK blocks minus 1 needed to load the 

file (maximum value Is 63). This information is stored 
for zero-compressed files only. 

Bits 24 - 35 in The date the file was last updated, according to the 

formula: ((year-1964) * 12 + (month-1)) * 31 + day -1 

Word 127 in of the directory block is unused. 

The message 

BAD DIRECTORY FOR DEVICE DTAn: EXEC CALLED FROM USER LOC n 
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occurs when any of the following conditions are detected: 

a . A parity error occurred while reading the directory block . 

b . No slots are assigned to the file number of the file. 

c . The tape block, which may be the first block of the file (i.e., the first block for the 
file encountered while searching backwards from the directory block), cannot be read. 



3 4 



BIT 35 
UNUSED 







82 
83 
84 

105 

106 

126 
127 10 


* 


* 














83 WORDS ■< 












+ 


+ 


+ 


+ 






FILENAME 1 


22 WORDS • 


FILENAME 2 






EXTENSION 1 ** DATE 1 




EXTENSION 2 DATE 2 


22 WORDS • 










ONE WORD LEFT OVER HERE 



NOTES' 

* Reserved for system, contains 36 as does block 144g for the 
directory. 

** For zero-compressed files, this area holds the number of 1K 
blocks -1 needed to load the file (up to 64K ). 

+ Represents blocks 1102 through 1105, which are not available, 



contains 37, 



8- 



Figure 6-1 DECtape Directory Format 
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6.1 .4 DECtape File Format 

A file consists of any number of DECtape blocks. 



END 



Dl RECTORY - 



BEGIN 

10-0573 



Figure 6-2 Format of a File on Tape 



Each block contains the following: 

Word Left half 

Right half 



Words 1 through 177, 



8 



The link. The link is the block number of the next 
block in the file. If the link is zero, this block is 
the last in the file. 

Bits 18 through 27: the block number of the first 

block of the file. Bits 28 through 35: a count of 

the number of words in this block that are used 

(maximum 177 Q ) . 
o 

Data packed exactly as the user placed in his buffer 
or in dump mode files, the next 127 words of memory . 



LINK 



FIRST BLOCK 
NUMBER 



WORD 
COUNT 



DATA 



Figure 6-3 Format of a DECtape Block 



6.1 .4.1 Block Allocation - Normally, blocks are allocated by starting with the first free block 
nearest the directory and going backwards to the front of the tape (block 0) . When the end of the 
tape is reached, the direction of the scan is reversed . Blocks are not written contiguously; rather 
they are separated by a spacing factor. This allows the drive to stop and restart to read the next 
block of the file wittiout having to back up the tape. The spacing factor is normally four, but for 
dump mode and UGETF followed by an ENTER, the spacing factor is two (refer to Paragraph 6.1 .6.3). 
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6.1.5 I/O Programming 

DECtape is a directory device; therefore, file selection must be performed by the user before data is 
transferred. File selection is accomplished with LOOKUP and ENTER UUOs. The UUO format is as 
fol lows: 

UUOD, E 

where D specifies the user channel associated with this device, and E points to a four-word parameter 
block. The parameter block has the following format: 



E 

E + l 
E+2 
E+3 



FILE 


EXT 


BLOCK* 





*of 1K BLOCKS 


DATE 


-N 


ADR-1 



where 

FILE is the filename in SIXBIT ASCII. 

EXT is the filename extension in SIXBIT ASCII. 

BLOCK # Is the number of the first block of the file. 

* of IK blocks is the number of blocks needed to load the file 
if the file is a zero-compressed file (bits 18-23) . 

DATE is the date the file was originally created in the format 
of the DAYTIME programmed operator (bits 24-35) . 

-N is the negative word length of the zero-compressed file. 

ADR-1 is the core address of the first word of the file minus 1 . 

Location E + 3 is used only for zero-compressed files. 

6.1 .5.1 LOOKUP D, E - The LOOKUP programmed operator sets up an input file on channel D. 
The contents of location E and E + 1 (left half) are matched against the filenames and filename exten- 
sions in the DECtape directory. If no match is found, tfie error return is taken. If a match is found, 
locations E + 1 through E + 3 are filled by the monitor, and the normal return is taken (refer to Table 
6-2). 
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Table 6-2 
LOOKUP Parameters 



On Call 


On Return 


Parameter 


Use 1 " 


Contents 


Parameter 


Uset 


Contents 


E 
E+l 

E+2 
E+3 


A 
A 

I 

I 


SIXBIT/FILE/ 
SIXBIT/EXT/ 


E 
E + 1 

E+2 
E+3 


V 

V 

V 
V 


SIXBIT/FILE/ 

LH= SIXBIT/EXT/ 
RH=first block* 

LH=0 

RH=# of IK blocks 
(Bits 18-23)tt 

creation date 
(Bits 24-35) tt 

IOWD LENGTH, 
ADRtt 


A= argument from user program, V =value from monitor, I = ignored . 

tt 

For zero-compressed files only. 



The first block of the file is then found as follows: 

a. The first 83 words of the DECtape directory are searched backwards, beginning with 
the slot immediately prior to the directory block, until the slot containing the desired 
file number is found . 

b . The block associated with this slot is read in and bits 18 through 27 of the first word of 
the block (these bits contain the block number of the first block of the file) are checked . 
If the bits are equal to the block number of this block, then this block is the first block; 
if not, then the block with that block number is read as the first block of the file. 



6.1 .5.2 ENTER D, E - The ENTER programmed operator sets up an output file on channel D. The 
DECtape directory is searched for a filename and filename extension, which match the contents of 
location E and the left half of location E + 1 . If no match is found and there is room in the directory, 
the monitor records the information in locations E through E + 2 in the DECtape directory (refer to 
Table 6-3) . An error return is given if there is no room in the directory for the file. If a match is 
found, the new entry replaces the old entry, the old file space is reclaimed immediately, and the 
monitor records the file information. This process is called superseding and differs from disk in that, 
because of the small size of DECtape, the space is reclaimed before the file is written rather than after. 
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Table 6-3 
ENTER Parameters 



On Call 


On Return 


Parameter 


Use f 


Contents 


Parameter 


Use 1 " 


Contents 


E 

E + 1 
E+2 

E+3 


A 
A 
A 

I 


SIXBIT/FILE/ 

SIXBIT/EXT/ 

RH = desired 
creation date or 
0. (0 implies 
current date) 


E 

E + 1 
E+2 

E+3 


V 
V 
V 

I 


SIXBIT/FILE/ 
LH = SIXBIT/EXT 
RH = creation date 


A=argument from user program, V= value from monitor, I = ignored. 



6.1 .5.3 RENAME D, E - The RENAME programmed operator alters the filename or filename extension 
of an existing file, or deletes the file directory from the DECtape associated with channel D. If lo- 
cation E contains a 0, RENAME deletes the directory of the specified file; otherwise, RENAME 
searches for the file and enters the information specified in location E and E + 1 into the DECtape 
directory (refer to Table 6-4) . RENAME must be preceded by a LOOKUP to select the file that is to 
be RENAMED and a CLOSE. The error return is given if a LOOKUP has not been done. 

Unlike on disk, a DECtape RENAME works on the last file LOOKUPed and ENTERed for the device, 
not the last file for this channel . The UUO sequence required to successfully RENAME a file on 
DECtape is as follows: 



LOOKUP 
RENAME 

or 

ENTER 
RENAME 



D,E 
D,E1 



D,E 
D,E1 



6.1 .5.4 INPUT, OUTPUT, CLOSE, RELEASE - When performing nondump input operations, the 
DECtape service routine reads the links in each block to determine what block to read next and when 
to raise the EOF flag . 
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Table 6-4 
RENAME Parameters 



On Call 


On Return 


Parameter 


Use 1 " 


Contents 


Parameter 


Use 1 " 


Contents 


E 


A 


SIXBIT/FILE/ 
or 


E 


V 


SIXBIT/FILE/ 


E +1 


A 


LH=SIXBIT/EXT/ 


E + 1 


V 


LH=SIXBIT/EXT/ 
RH = error code on 

error return 
0=old name not found 
4=rename to existing 

name 


E +2 


I 


- 


E +2 


I 


- 


E +3 


I 


- 


E+3 


I 


- 


'A=argum 


snt from user program, V=value from monitor, ! 


= ignored 





When an OUTPUT is given, the DECtape service routine examines the left half of the third word in the 
output buffer (the word containing the word count in the right half) . If this half contains -1 , it is 
replaced with a before being written out, and the file is thus terminated. If this half word is greater 
than 0, it is not changed and the service routine uses it as the block number for the next OUTPUT. If 
this half word is 0, the DECtape service routine assigns the block number of the next block for the 
next OUTPUT. 

For both INPUT and OUTPUT, block 100 (the directory) is treated as an exception case. If the user's 
program gives 

USETI D, 144 8 
to read block 100, it is treated as a 1 -block file. 

The CLOSE operator places a -1 in the left half of the first word in the last output buffer, thus termi- 
nating , the file. 

The RELEASE operator writes rhe copy of the directory, which is normally kept in core onto block 100, 
but only if any changes have been made. Certain console commands, such as KJOB or CORE 0, 
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perform an implicit RELEASE of all devices and, thus, write out a changed directory even though the 
user's program failed to give a RELEASE (refer to Chapter 2). 

6.1 .6 Special Programmed Operator Service 

Several programmed operators are provided for manipulating DECtape. These UUOs allow the user to 
manipulate block numbers and to handle directories. 

6.1 .6.1 USETI D, E - The USETI programmed operator sets the DECtape on channel D to input block 
E next. Input operations on the DECtape must not be active; otherwise, the user has no way of determi- 
ning which buffer contains block E . 

6.1 .6.2 USETO D, E - The USETO programmed operator sets the DECtape on channel D to output 
block E next. USETO waits until the device is inactive before setting up the new output block number. 

6.1 .6.3 UGETF D, E - The UGETF programmed operator places the number of the next free block of 
the file in the user's location E. 

If UGETF is followed by an ENTER, the monitor modifies its algorithm in the following manner: 

1) the first block is written nearest the front of the tape instead of nearest 
the directory. 

2) the spacing factor is changed to 2 instead of 4 so that very large programs 
can fit almost entirely in a forward direction. 

This feature allows user programs, such as PIP, to write SAV format files which can be read by the 
executive mode utility program TENDMP (see the PDP-10 Software Notebook). 

6.1 .6.4 CALL AC, [SIXBIT/UTPCLRIl or CALLI AC, 13 - The UTPCLR programmed operator clears 
the directory of the DECtape on the device channel specified in the AC field. A cleared directory has 
zeroes in the first 83 words except in the slots related to blocks 0, 1,2, and 100-iq and nonexistent 
blocks 1102 through 11058. Only the directory block is affected by UTPCLR. This programmed oper- 
ator is a no-operation if the device on the channel is not a DECtape. 

6.1 .6.5 MTAPE D, 1 and MTAPE D, 1 1 - MTAPE D,l rewinds the DECtape and moves it into the end 
zone at the front of the tape. MTAPE D,ll rewinds and unloads the tape, pulling the tape competely 
onto the left-hand reel . These commands affect only the physical position of the tape, not the logical 
position. When either is used, the user's job can be swapped out while the DECtape is rewinding; 
however, the Job cannot be swapped out if an INPUT or OUTPUT is done while the tape is rewinding . 
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6.1 .6.6 DEVSTS UUO - After each interrupt, the DECtape service routine stores the results of a 
CONI in the DEVSTS word of the device data block. The DEVSTS UUO is used to return the contents 
of the DEVSTS word to the user (refer to Paragraph 4.9.3.4). 

6.1 .7 File Status (Refer to Appendix D) 
The file status of the DECtape is shown below. 
Standard Bits 



18 21 24 27 30 33 



35 



SET BY USER 



SET BY MONITOR 



Bit 18 - IOIMPM 

Bit 19 - IODERR 
Bit 20 - IODTER 
Bit 21 -IOBKTL 
Bit 22 - IOEOF 

Bit 23 - IOACT 



An attempt was made to read block in nonstandard 
dump mode. 

Data was missed . 

Parity error. 

Block number is too large or tape is full on OUTPUT. 

EOF mark encountered on input. No special character 
appears in buffer. 

Device is active. 



18 



UNUSED 



21 



24 



27 



30 



33 



35 



Device Dependent Bits 



18 



SET BY USER 



21 



24 



27 29 30 33 



35 






Bit 29 



DECtape is in a nonstandard- I/O mode format as opposed 
to standard- I/O mode. No file-structured operations are 
performed on the tape. Blocks are read or written sequen- 
tially; no links are generated (output) or recognized (input). 
The first block to be read or written must be set by a USETI 
or USETO. In nonstandard- I/O mode, up to 2008 words per 
block are read or written as user data (as opposed to the 
standard mode of 1 link plus word count followed by 177_ 
words). No dead reckoning is used on a search for a block 



Revision 1 Monitors 
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January 1971 



Bit 29 (Cont) number as the tape may be composed of blocks shorter 

than 200 words . The ENTER, LOOKUP, and UTPCLR 
UUOs are treated as no-ops . Block of the tape may 
not be read or written in dump mode if bit 29 is on, 
because the data must be read in a forward direction 
and block normally cannot be read forward. 



6.1.8 Important Considerations 

If an attempt is made to write on a write-locked tape or to access a drive that has no tape mounted, 
the message 

DEVICE DTAn OK? 

is given. When the situation has been rectified, CONT may be typed to proceed. 

The DECtape service routine reads the directory from a tape the first time it is required to perform a 
LOOKUP, ENTER, or UGETF; the directory image remains in core until a new ASSIGN command is 
executed from the console. To inform the DECtape service routine that a new tape has been mounted 
on an assigned unit, the user uses an ASSIGN command. The directory from the old tape can be trans- 
ferred to the new tape, thus destroying the information on that tape unless the user reassigns the DEC- 
tape transport every time he mounts a new reel . 

Although DECtape is a file-structured blocked device, there is a limit to the number of files that may 
be opened simultaneously on a single DECtape. A given DECtape may be OPENed or INITed on two 
software channels (maximum) at the same time, once for INPUT and once for OUTPUT. An attempt to 
INITon two channels for INPUT or two channels for OUTPUT generates no error indication, and only 
the most recent INIT is effective. This restriction explains why the following examples do not work. 



Example 1: 



•R SRCCOM 

*TTY:-DTA1 :P1 ,DTA1 :P2 



SRCCOM accepts the command string but the comparison does not work because the DECtape cannot 
be associated with the input side of two software channels at the same time. 



Example 2: 



•R MACRO 

*DTA1 :BIN.»DTA1 : LST-DTA2 :PR0G 
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MACRO accepts the command string but does not produce the desired results because a single DECtape 
cannot be associated with the output side of two software channels at the same time. However, the 
following example works, because only one file is opened for reading and one file for writing . 



•R MACRO 

*DTA1 :BIN«-DTA1 :SOURCE 



6.2 DISK 

The device mnemonic is DSK, FHA, DPA; the buffer size is 203 o (200 o data) words. 

o o 



6.2.1 Data Modes 

6.2.1 .1 Buffered Data Modes - Data is written on the disk exactly as it appears in the buffer. Data 
consists of 36-bit words. 

CAUTION 

All buffered mode operations utilize a 200 octal word 
data buffer. Attempts to set up non-standard buffer 
sizes are ignored. In particular, attempting to use 
buffer sizes smaller than 200 words for input result in 
data being read in past the end of the buffer destroy- 
ing what information was there (e.g., the buffer 
header of the next buffer) . 



6.2.1 .2 Unbuffered Data Modes - Data is read into or written from anywhere in the user's core area 
without regard to the normal buffering scheme. Control for read or write operations must be via a 
command list in core memory. The command list format is described in Paragraph 4.10.5.1 . The disk 
control automatically measures dump data into standard-length disk blocks of 200 octal words. Unless 
the number of data words is an exact multiple of the standard length of a disk block (200 words) after 
each command word in the command list, the remainder of that block is wasted. 

6.2.2 Structure of Disk Files 

The file structures of a disk system minimize the number of disk seeks for sequential or random access- 
ing during either buffered or unbuffered I/O . The assignment of physical space for data is performed 
automatically by the monitor when logical files are written or deleted by user programs. Files may 
be any length, and each user may have as many files as he wishes, as long as disk space is available 
and the user has not exceeded his logged-in quota. Users or their programs do not need to give initial 
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estimates of file length or number of files . Files may be simultaneously read by more than one user at 
a time, thus allowing data sharing . A new version of a file may be recreated by one user while other 
users continue to read the old version, thus allowing for smooth replacement of shared programs and 
data files. Finally, one user may selectively update portions of a file, rather than creating a new one. 

6.2.2.1 Addressing by Monitor - The file structure described in this section is generally transparent 
to the user, and a detailed knowledge of this material is not essential for effective user-mode use of 
the disk. One set of disk-independent file handling routines in the timesharing monitor services all 
disks and drums. This set of routines, FILSER, interprets and operates upon file structures, processes 
disk UUOs, queues disk requests and makes optimization decisions. The monitor deals primarily with 
logical units within file structures and converts to physical units in the small device-dependent rou- 
tines just before issuing I/O commands. All queues, statuses, and flags are organized by logical unit 
rather than by physical unit. The device-dependent routines perform the I/O for specific storage 
devices and translate logical block numbers to physical disk addresses. 

All references made to disk addresses refer to the logical or relative addresses used by the system and 
not to any physical addressing scheme involving records; sectors, or tracks that may pertain to a par- 
ticular physical device. The basic unit that may be addressed is a logical disk block, which consists 

of 200 o 36-bit words, 
o 

6.2.2.2 Storage Allocation Table (SAT) Blocks - Unique to each file structure is a file named 
SAT. SYS. This file reflects tfie current status of every addressable block on the disk. Only the 
monitor can modify the contents of SAT. SYS as a result of file creation, deletion, or space allocation, 
although this file may be read by any user. The SAT file consists of bits indicating the portion of file 
storage in use and the portion that is available. To reduce the size of SAT. SYS, each bit can be 
used to represent a contiguous set of blocks called a cluster . Monitor overhead is decreased by as- 
signing and releasing file storage in clusters of blocks rather than single blocks. 

If a particular bit is on, it indicates that the corresponding cluster is filled with data (all blocks on the 
disk are filled when any information is written on them) or is bad or nonexistent; if the bit is off, it 
indicates that the corresponding cluster is empty, or available to be written on. 

6.2.2.3 File Directories - There are two levels of directories in each file structure: 

a. The master file directory (MFD) 

b. The user file directory (UFD). 
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The master file directory consists of two-word entries; the entries are the names of the user file direc- 
tories. The first word of each entry contains the project-programmer number of the user. The left 
half of the second word of each entry contains the mnemonic UFD in SIXBIT and the right half contains 
a pointer to the first cluster of the user file directory (see Figure 6-4). The main function of the master 
file directory is to serve as a directory for individual user file directories. 

The entries within a user file directory are the names of files existing in a given project-programmer 
number area within the file structure. The first word of each entry contains the filename in SIXBIT. 
The left half of the second word contains the filename extension in SIXBIT, and the right half contains 
a pointer to the first cluster of the file (see Figure 6-4). This pointer specifies both the unit and the 
super-cluster of the file structure in which the file appears . The right half of the directory entry is 
referred to as a compressed file pointer (CFP). 

When the user is logged-in, each file structure for which he has a quota contains a UFD for his project- 
programmer number. Each UFD contains the names of all the user's files for that file structure only. 
The term disk directory refers to all the UFDs for a particular project-programmer number. A user is 
not prevented from attempting to read a file in another user's UFD on a file structure for which he 
does not have a UFD . Whether or not the user is successful depends on the protection specified for the 
file being referenced. 



MASTER FILE 
DIRECTORY 



USER FILE 
DIRECTORS 



DATA FILES 









— » 


1 


1 






UFD 












10 


10 






UFD 








20 


20 






UFD 








• 






Figure 6-4 Basic Disk File Organization 
for Each File Structure 
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To improve disk access and core searching times, only UFD names are kept in the MFD (project- 
programmer number 1,1). All CUSPs and monitor file structure files are contained in another project- 
programmer number directory called the system library. For convenience to users typing commands 
and to user programs, device name SYS is interpreted as the system library; therefore, no special 
programming is required to read as a specific file from device SYS. 

6.2.2.4 File Format - All disk files (including MFD and UFDs) are composed of two parts: 

a . pure data 

b. information needed by the system to retrieve this data. 

Each data block contains exactly 200 (octal) words. If a partially filled buffer is output to the disk by 
a user, a full block is written with trailing zeros filling in to make 200- words. A partial block input 
later appears to have a full 200_ data words. Word counts associated with individual blocks are not 
retained by the system except in the case of the last block of the file. 

There are three links in the chain by which the system references data on the disk. This chain Is 
transparent to the user, who might look on the directory as having four-word entries analogous to DEC- 
fapes. The first link is the two-word directory entry, which points to the second link, the retrieval 
information block (RIB). The RIB, in turn, points to the third link, the individual data blocks of the 
file (see Figure 6-5). 

The retrieval block contains all the pointers to the entire file. Retrieval information associated with 
each file is stored and accessed separately from the data; therefore, system reliability is increased and 
the number of positionings necessary for random access is reduced. 

For recovery purposes, a copy of the retieval information block is written immediately after the last 
data block of the file when a CLOSE is completed. If the first RIB is lost or bad, the monitor can 
recover by allowing a recovery program to use the second RIB; therefore, a data file of n blocks has 
two additional overhead blocks: relative block 0, containing the primary RIB; and relative block 
n + 1, containing the redundant RIB (refer to Appendix I). 

6.2.3 Access Protection 

Nine bits of the retrieval information of a file are used to specify the protection of the file. This 
procedure is necessary because a disk is shared by many users, each of whom may desire to keep certain 
files from being written on, read, or deleted by other users. 
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Users are divided into three categories: the owner of the file, the members with the owner's project 
number, and all others. Each UFD in a file structure is associated with a distinct project-programmer 
number pair. 
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Any user who is logged in with the same programmer number is considered to be the owner of the files 
in that UFD; therefore, the same programmer numbers can be assigned to different users in different 
projects. However, a user who is working on more than one project cannot have the same access to 
all files he has written . Some installations may decide that a user is not an owner unless both the 
project and programmer number the user is logged in under match the pair associated with the UFD. 
This decision Is made at monitor generation time with the MONGEN program. 

A user is allowed project access if the programmer number he is logged in under is different from the 
one associated with the UFD, but his project number is the same as the one associated with the UFD. 

The three bits associated with each category of users are encoded as follows: 

Code Access Protection 

7 No access privileges. File may be looked up if the UFD 

permi ts . 

6 Execute only. 

5 Read, execute. 

4 Append, read, execute. 

3 Update, append, read, execute. 

2 Write, update, append, read, execute. 

1 Rename, write, update, append, read, execute. 

Change protection, rename, write, update, append, 

read, execute. 

The greatest protection a file can have is 7, and the least protection is 0. It is always possible for the 
owner of a file to change the access protection associated with that file even if the owner-protection 
field is set to 0; thus, and 1 are equivalent in the owner field. Access protection can be changed by 
executing a RENAME UUO or by using the RENAME switch in PIP as follows: 



■ R PIP 

♦FILE* EXT <NEW PROT>/R~FILE . EXT 



When a file is created with a protection code of 000, the monitor substitutes the standard protection 
code as defined by the installation . The normal system standard is 057. This protection prevents users 
in different projects from accessing another user's files; however, a standard protection of 055 is re- 
commended for in-house systems where privacy is not as important as the capability of sharing files 
among projects. No program should be coded to assume knowledge of the standard protection. If it 
necessary to use this standard, it should be obtained through the GETTAB UUO . 
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To preserve files with LOGOUT, a protection code of 1 in the owner's field should be associated with 
the files. LOGOUT preserves all files in a UFD for which the protection code for the owner is greater 
than zero . 

6.2.3.1 UFD Privileges - The protection code associated with each file completely describes the 
access rights to that file independently of the protection code of the UFD. UFDs may be read in the 
same manner as files but cannot be written explicitly, because they contain RIB pointers to particular 
disk blocks. For UFD privileges, users are divided into the same three categories as for files. Each 
category has three independent bits: 

Code Access Privileges 

4 Allow LOOKUPS in UFD. 

2 Allow CREATES in UFD. 

1 Allow the UFD to be read as a file. 

The owner is permitted to control access to his own UFD . It is always legal for the owner to issue a 
RENAME to change the protection of his UFD. Only privileged programs are allowed to create, super- 
sede, or delete a UFD . The monitor checks for the following types of privileged programs: 

a. Jobs logged in under project-programmer number 1,2. (FAILSAFE) 

b . Jobs running with the JACCT bit set in JBTSTS (LOGIN , LOGOUT) . 

Privileged programs are allowed to: 

a . Create UFDs 

b. Delete UFDs 

c. Set privileged LOOKUP, ENTER, and RENAME arguments 

d . Ignore fi I e protection codes . 

6.2.4 Disk Quotas 

Each project-programmer number in each file structure is associated with two quotas that limit the 
number of blocks that can be stored under the UFD in the particular file structure. The quotas are: 

a . Logged-in quota 

b . Logged-out quota . 

When the user logs in, he automatically starts using his logged-in quota. This is not a guaranteed 
amount of space, and the user competes with other users for it. The logged-out quota is the amount of 
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space that the user must be within in order to log off the system . Normally, the logged-out quota is 
less than or equal to the logged-in quota, so that the user must delete temporary files. 

If a user exceeds his logged-in quota, the monitor types the following message: 
[ EXCEEDING QUOTA ON ft 1 

where fs is the name of the file structure. The message appears in square brackets (like the TECO core 
expansion message) to suggest a warning rather than an error. Unlike most monitor messages, tfiis 
message indicates that the user program may continue to run, and the console remains in user mode. 
The user program can no longer create or supersede files (ENTER gives an error return). Files already 
ENTERed are allowed to continue for a specified amount of blocks. This amount is called the over- 
drawn amount and is a parameter of the file structure. The overdrawn amount specifies the number of 
blocks by which the logged-in UFD may exceed its logged-in quota. When the user exceeds the over- 
drawn amount, the IOBKTL bit is set, and further OUTPUTs are not allowed. A CLOSE operates 
successfully, including the writing of the last buffers and the RIBs. 

When the user logs in, the LOGIN CUSP reads the logged-in quota from the file AUXACC.SYS for 
all public file structures in which the user is allowed to have a UFD. This information is passed to the 
monitor where it is kept in core. If the quota has changed since the user logged in last, LOGIN up- 
dates (or creates) the RIB of each UFD with the new quotas. 

6.2.5 Simultaneous Access 

In its core area, the monitor maintains two four-word blocks called access blocks . These blocks control 
simultaneous access to a single file by a number of user channels. All active files have access blocks 
that contain file status information . The access blocks ensure that a maximum of one user channel 
supersedes or updates a given file at a given time. 

6.2.6 File Structure Names 

Each file structure has a SIXBIT name specified by the operator at system initialization time. The 
recommended names for the file structures in the public pool are DSKA, DSKB, . . ., DSKN (in order 
of decreasing speed) . Names for private file structures may be any name starting with a letter. The 
system manager should ensure that private file structure names do not conflict with any device or file 
structure name or its abbreviation. 
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When a specific file structure is INITed (e.g., DSKA), LOOKUP and ENTER searches are restricted 
to that file structure. Usually a channel is INITed with the generic name DSK, in which case all file 
structures in the active search list of the job are searched (refer to Paragraph 6.2 .7) . 

6.2.6.1 Logical Unit Names - When a single file structure name is specified, the set of all the units 
in that file structure is implied; however, it is possible to specify a particular logical unit within a 
file structure (e.g., DSKAO, DSKA1 , DSKA2 are three logical units in the file structure DSKA). The 
monitor deals with file structures rather than with individual units; therefore, when reading files, 
specifying a logical unit within a file structure is equivalent to specifying the file structure itself. The 
monitor locates the file regardless of which unit it is on within a file structure. However, in writing a 
file, the monitor uses the logical unit name as a guide in allocating space and will, if possible, write 
the file on the unit specified. In this way, a user can separate files on to different units for increased 
throughput . 

6.2.6.2 Physical Controller Class Names - In addition to DSK, single file structure names (DSKA), 
and logical unit names (DSKAO), it is possible to specify a class of controllers. If the system has one 
controller of the type specified, the result is the same as if the user had specified the physical controller 
name. The controller classes supported by DEC are: 

DR (future drum) , FH, DP, MD 

6.2.6.3 Physical Controller Names - It is possible to specify any of the units on a particular controller. 
The monitor relates that name to the file structures, which contain at least one unit on the specified 
controller. More than one file structure may be specified when a physical controller name is used. The 
controllers that DEC supports are: 

DRA, DRB (future drum), FHA, FHB, DPA, DPB, MDA 

6.2.6.4 Physical Unit Names - When a physical controller name is specified, all units on that con- 
troller are implied. It is possible to specify a physical unit name on a particular controller. The 
physical unit names that DEC supports are: 

DRAO, DRBO Reserved for future drum (RX10) . 

FHAO, . . . ,FHA3 Mixture of Burroughs fixed-head disks (RD10) 

and Bryant drums (RM10B) on RC10 control . 

FHBO, . . . ,FHB3 Mixture of Burroughs fixed-head disks (RD10) 

and Bryant drums (RM10B) on second RC10 control . 
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DPAO, 


..., DPA7 


DPBO, 


. . . , DPB7 


MDAO 




MDBO 





Mixture of RP01 and RP02 Memorex disk packs 
on RP10 control . 

Mixture of RP01 and RP02 Memorex disk packs 
on second RP10 control . 

Single-positioner Bryant mass disk (RBI OB) on 
RA10 control . 

Single-positioner Bryant mass disk (RB10B) on 
second RA10 control . 



6.2.6.5 Unit Selection on Output - If the user specifies a file structure name on an ENTER, the 
monitor chooses the emptiest unit on the file structure which does not currently have an open file 

| (UFD's are not considered opened) for the job. This selection improves disk throughput by distributing 
files for a particular job on different units. For example, in a MACRO assembly with two output files 
and one input file, it is probable that the monitor would allocate the output files on separate units 
from each other and from the input file. If this were the only job running, there would be almost no 
seeks. Therefore, to take advantage of this, programs should LOOKUP input files before ENTERing 
output files. 

6.2.6.6 Abbreviations - Abbreviations may be used as arguments to the ASSIGN command and the 
INITand OPEN UUOs. The abbreviation is checked for a first match when the ASSIGN, IN IT, or 
OPEN is executed. The file structure or device eventually represented by the particular abbreviation 
depends on whelber a LOOKUP or ENTER follows. A LOOKUP applies to as wide a class of units as 
possible; however, an ENTER applies to a restricted set to allow files to be written on particular units 
at the user's option. For example, consider the following configuration: 



File Structure 




Physical Unit 


DSKA 


= 


FHAO, FHA1 


DSKB 


= 


FHA2, FHBO, FHB1 


DSKC 


= 


DPAO, DPA1, DPA2, DPA3 


DSKD 


= 


DPBO, DPB1 , DPB2 


PRVA 


= 


DPB3 



Table 6-5 shows the file structures and units implied by Hie various names and abbreviations. 
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Table 6-5 
File Structure Names 



Argument Supplied 


File Structures or Units Implied 






to ASSIGN, INIT, OPEN 


LOOKUP 


ENTER 


D, DS, DSK 


Generic DSK according to job search 




list (refer to Paragraph 6.2.7) 


P, PR, PRV, PRVA 


DPB3 


DPB3 


F, FH, FHA 


DSKA, DSKB 


FHAO 


FHB 


DSKB 


FHBO 


FHAO 


DSKA 


FHAO 


FHBO 


DSKB 


FHBO 


DP 


DSKC, DSKD, PRVAt 


DSKC 


DPA 


DSKC 


DSKC 


DPB 


DSKD, PRVAt 


DSKD 


DPAO 


DSKC 


DPAO 


DPB2 


DSKD 


DPB2 


DPB3 


PRVA 


PRVA 


Only if user has done a MOUNT 


(available in 5.02 monitors and later monitors) . 



6.2.7 Job Search List 

To a user, a file structure is like a device; that is, a file structure or a set of file structures may be 
specified by an INIT or OPEN UUO or by the first argument of the ASSIGN command . A console user 
specifies a file structure by naming the file structure and following it with a colon. 

There is a flexible naming scheme that applies to file structures; however, most user programs INIT 
device DSK, which selects the appropriate file structure, unless directed to do otherwise by the user. 
The appropriate file structure is determined by a job search list. A job search list is divided into two 
parts: 

a. an active search list (usually referred to as the job search list), and 

b. a passive search list. 
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The active search is an ordered list of rhe file structures that are to be searched on a LOOKUP or 
ENTER when device DSK is used . The passive search list is an unordered list of file structures main- 
tained by the monitor for LOGOUT time. At this time, LOGOUT requires that the total allocated 
blocks on each UFD in both the active and passive search lists be below the logged-out quota. Each 
job has its own active search list (established by LOGIN) with file structures in the order that they 
appear in the administrative control file AUXACC.SYS. Thus, a user has a UFD for his project- 
programmer number in each file structure in which LOGIN allows him to have files. With the MOUNT 
command, mounted file structures may be added to the active search list. The following is an example 
of a search list: 

DSKB, DSKA, FENCE, DSKC 

DSKB and DSKA comprise the active search list. These file structures are represented by generic name 
DSK for this job. DSKC is the name of a file structure that was previously in the active search list. 
FENCE represents the boundary between the active and passive search list. 

Each file structure in a job search list may be modified by setting one of two flags: 

a . Do not create in this structure if just generic DSK is specified . 
b. Do not write in this structure. 

Setting the do not create flag indicates that no new files are to be created on this file structure unless 
explicitly state. For example: if the "don't create" flag is set 

DSKA: FOO- 

allows FOO to be created on DSKA, but 

DSK: FOO- 

does not. For LOOKUPs on device DSK, the monitor searches the structures in the order specified by 
the job search list. For ENTERs the file is placed on the first structure in the search list that has space 
and does not have the do not create flag set. 

6.2.8 User Programming 

Three types of writing on the disk may be distinguished. If a user does an ENTER with a filename 
which did not previously exist in his UFD, he is said to be creating that file. If the filename previously 
existed in his UFD, he is said to be superseding that file; the old version of the file stays on the disk 
(and is available to anyone who wants to read it) until the user does the output CLOSE . At the time of 
the CLOSE, the user's UFD is changed to point to the new version of the file and the old version is 
either deleted immediately or marked for deletion later if someone is currently reading it; the space 
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occupied by deleted files is always reclaimed in the SAT tables (refer to Paragraph 6.2.2.2). Finally, 
if a user does a LOOKUP followed by an ENTER (the order is important) on the same filename on the 
same user channel, he will be able to modify selected blocks of that file, using USETO and USETI UUOs 
(refer to Paragraph 6.2.8.3) without creating an entirely new version; this third type of writing, called 
updating, eliminates the need to copy a file when making a small number of changes. 

As a standard practice, user programs should read, create, and supersede (new file with same filename) 
files on different user channels. However, for compatibility with DECfapes, it is possible to read and 
create, or read and supersede, two files on the same user channel as long as all OUTPUTs and the 
CLOSE output are done before the LOOKUP and the first input, or vice versa. In other words, a 
CLOSE UUO is required between successive LOOKUPS and ENTERs unless updating is intended. 

The actual file structure of the disk is generally transparent to the user. In programming for I/O on 
the disk, a format analogous to mat of DEC tapes is used; that is, the user assumes a four-word directory 
entry similar in form to the first four words of retrieval information. The UUO format is approximately 
the same as for DECtapes: 

UUO D,E 

where UUO is an I/O programmed operator, and D specifies the user channel associated with this 
device. E points either to a four-word directory entry or an extended argument block in the user's 
program . 

6.2.8.1 Four-Word Arguments for LOOKUP, ENTER, RENAME UUOs - The four-word argument 
block has me following format: 



E 

E+1 

E+2 

E+3 



NAME 


EXT jllllll 


DATE 1 


PROT 


M 


TIME 


DATE 2 


PROJECT 
NUMBER 


PROGRAMMER 
NUMBER 



OR 
E+3 



-WORD COUNT 






where 



NAME is the filename in SIXBIT ASCII, if a UFD, or the project- 
programmer number in binary, if a MFD. 

EXT is the filename extension in SIXBIT ASCII, if a UFD, or the word 
UFD, if a MFD. 

DATE 1 is the date me file was last referenced (RENAME, ENTER, or 
INPUT) in the format of the DATE UUO (bits 24-35) . 
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PROT is the protection code for me file (bits 0-8). 

M is the data mode (ASCII, binary, dump) (bits 9-12). 

TIME is the time that the file was originally created (bits 13-23) . 

DATE 2 is the date (in the same format as DATE 1) that the file was 
originally created (bits 24-35) . 

The programmed operators (UUOs) operate as follows: 

a. ENTER UUO - ENTER D, E causes the monitor to store the four-word directory 
entry for later entry into the proper UFD when user channel D is closed or 
released. 



NAME 
EXT 
DATE 1 

PROT 



The filename must be nonzero; otherwise, an 
error return results. 

The filename extension may be zero; if so, the 
monitor leaves it as zero . 

The date may be zero, in which case the monitor 
substitutes the current date. The date must not be 
in the future; if this is so, the current date is used. 

If the protection code is 0, the monitor substitutes 
the installation standard as specified at MONGEN 
time. If the protection code is and this ENTER 
is superseding a file, the protection of the new file 
is copied from the old file. RENAME may be used 
to change the protection after a file has been 
completely written and when it is being closed. 

The data mode is supplied by the monitor. It was 
set by the user in the last INIT or SETSTS UUO on 
channel D . 

If both of these are 0, the monitor supplies the 
current date and time as the creation date and time 
for the file. If either is nonzero, the monitor uses 
the TIME and DATE 2 supplied by the user E +2; 
thus, files may be copied without changing the 
original creation time and date. 

If both of these are 0, the project-number and 
programmer-number (binary) under which the user is 
logged in is supplied by the monitor. Otherwise, 
the monitor uses the project-number and programmer- 
number supplied by the user in E +3. However, it is 
generally not possible to create (ENTER) files in an- 
other user's area of the disk, because UFDs are usually 
protected against creation with all but the owner. 

With certain types of error returns peculiar to the disk, the right half of E + l is set 
to a specific number to indicate the error that caused the return . Refer to Appendix 
E for the error codes returned on the ENTER UUO . 



M 



TIME, DATE 2 



PROJECT NUMBER 
PROGRAMMER NUMBER 
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When an ENTER is executed by the monitor on a file that exists, a new file by 
that name is written, and those bits in the SAT blocks that correspond to the 
blocks of the old file are zeroed when the CLOSE (or RELEAS) UUO is executed 
provided that bit 30 of the CLOSE is (refer to Paragraph 4.10.7.7). Space is 
thereby retrieved and available to other users after the new file has been success- 
fully written. If a file structure is INITed on channel D, the monitor maximizes 
the job's throughput by selecting the emptiest unit for which the job has no opened 
files (refer to Paragraphs 6.2.6.5 and 6.2.6.6). 
b . LOOKUP UUO - LOOKUP D , E causes the monitor to read the appropriate UFD . If 
a later version of the file is being written, the old version pointed to by the UFD read. 

NAME The same as on an ENTER. 

EXT The same as on an ENTER. 

DATE 1 , PROT, M, These arguments are ignored. The monitor 

TIME, DATE 2 returns these quantities to the user in E+l and 

E+2. 

PROJECT NUMBER, If both of these are 0, the project-number and 

PROGRAMMER NUMBER programmer-number (binary) under which the user 

is logged in is supplied by the monitor. Other- 
wise, the monitor uses the project-number, 
programmer-number supplied by the user in E+3. 
Thus, it is possible to read files in other user's 
directories, provided the file's protection mask 
permits reading and the UFD permits LOOKUPS. 

The monitor returns the negative word count (or positive block count for files larger 
man V 7 words) in the LH of E +3, in RH of E +3 . As a result, the monitor treats 
a negative project-programmer number as if it were 0, however, this will not always 
be true; therefore, programs must be written to either clear E +3 before doing a 
LOOKUP, ENTER, or RENAME or set E+3 to the desired project-programmer 
number. In the future, a negative project-programmer number may be used to 
indicate SIXBIT alphabetic characters for project and programmer initials. 

The numbers placed in the RH of E +1 on an error return have a significance 
analogous to that described for the ENTER UUO (refer to Appendix E) . 

If the file is currently being superseded, the old file is used . 

c. RENAME UUO - RENAME D, E is used to alter the filename, the filename 
extension/protection of a file, or to delete a file from the disk . Locations E 
through E +3 are as described for ENTER. To RENAME a file, a LOOKUP or 
ENTER must first be done to identify the file for the RENAME UUO . CLOSE 
is optional because RENAME performs a CLOSE. In fact, to minimize disk 
accesses, a RENAME should not be preceded by a CLOSE. 

RENAME enters me information specified in E through E+2 into the retrieval 
information and proper directory. If the contents of E is zero, RENAME has the 
effect of deleting the file. 

The error codes in the right half of E + l are the same as for ENTER (refer to 
Appendix E). 

When issuing a RENAME UUO, the user must ensure that the status at locations 
E through E +3 are as he desires . An ENTER or LOOKUP must have preceded the 
RENAME; therefore, the contents of E through E+3 will have been altered, or 
fil led if the E is the same for all UUOs. If E +3 has a different project-programmer 
number than the one in which the file is LOOKUPed or ENTERed, the monitor 
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deletes the directory entry from the old UFD and inserts the directory entry in the new 
UFD, provided the user has the privileges to delete files from the old UFD, and to 
create files in the new UFD. This is an efficient way to move a file from one 
directory to another, since no I/O needs to be done on the data blocks of the file. 



6.2 .8.2 Extended Argument for LOOKUP, ENTER, RENAME UUOs - A number of quantities have 
been added to the existing four-word block . The user program may specify exactly the number of 
words in the argument block . If the left half of E is and the right half of E is three or greater, the 
right half of E is interpreted as the count of the number of words which follow . If the right half of 
E is less than three, a file-not-found return is given because the user program is not supplying enough 
arguments. Allowed arguments supplied by the user program are returned by the monitor as values. 
If the user program supplies arguments that are not allowed, the monitor ignores these arguments and 
supplies values on return . Table 6-6 indicates the arguments that may be supplied by a user program . 



Table 6-6 

Extended LOOKUP, ENTER, and 

RENAME Arguments 



Rel. Loc 


Symbol 


Lookup 


Create 
Supers 


Update 
Rename 


Arguments and Value 





- 


A 


A 


A 


Count of arguments following 


1 


.RBPPN 


A0 


A0 


A0 


Directory name (project-programmer no.) 


2 


.RBNAM 


A 


A 


A 


Filename in SIXBIT 


3 


.RBEXT 


A 
V 


A 
A0 


A 
A 


File extension (LH) 
Access date (bits 24-35) 


4 


. RBPRV 


V 
V 
V 
V 


A0 
V 
A0 
A0 


A 
V 
A 
A 


Privilege (bits 1-8) 
Mode (bits 9-12) 
Creation time (bits 13-23) 
Creation date (bits 24-35) 


5 


.RBSIZ 


V 


V 


V 


Length of file in data words written 
(+no. words) 


6 


• RBVER 


V 


A 


A 


Octal version number (36 bits) 


7 


.RBFUT 


V 


A 


A 


Reserved for future 


10 


.RBEST 


V 


A 


A 


Estimated length of file (+no. blocks) 


11 


.RBALC 


V 


A 


A 


Highest relative block number within F.S. 
allocated by user or monitor to file (not 
counting 2nd RIB) 


12 


.RBPOS 


V 


A 


A 


Logical block no. of first block to allocate 
within F.S. 


13 


.RBFT1 


V 


A 


A 


Future nonprivileged argument - reserved 
for DEC J 
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Table 6-6 (Cont) 
Extended LOOKUP, ENTER, and 
RENAME Arguments 



Rel . Loc 



14 

15 
16 
17 

20 
21 



22 
23 
24 
25 
26 

27 
30 

31 

32 



Symbol 



.RBNCA 

.RBMTA 
•RBDEV 
.RBSTS 

.RBELB 
.RBEUN 



.RBQTF 
.RBQTO 
• RBQTR 
.RBUSD 
.RBAUT 

.RBNXT 
.RBPRD 

.RBPCA 

.RBUFD 



Lookup 



V 
V 
V 

V 
V 



V 
V 
V 
V 
V 

V 
V 

V 

V 



Create 
Supers 



Al 

V 

Al 

V 
V 

V 

Al 
Al 
Al 
Al 
Al 

Al 
Al 

Al 

Al 



Update 
Rename 



Al 

V 

Al 

V 
V 

V 

Al 
Al 
Al 
Al 
Al 

Al 
Al 

Al 

V 



Arguments and Value 



Nonprivileged argument reserved for customer 
to define 

Tape label if on backup tape 

Logical unit name on which the file is located 

1) LH =Combined status of all files in UFD 

2) RH=Status of this file 

Bad logical block within error unit 

1) LH=Logical unit no. within F.S. of bad 

unit(0,,,N). 

2) RH =No . of consecutive blocks in bad 

region 

(UFD-only) FCFS logged-in quota in blocks 

(UFD-only) logged-out quota in blocks 

(UFD-only) reserved logged-in quota 

(UFD-only) no. of blocks used at last logout 

Author porject-programmer number (creator 
or superseder) 

Next file structure name if file continued 

Predecessor file structure name if file 
continued 

Privileged argument word reserved for each 
customer to define as he wishes 

Logical block number within F.S. (not 
cluster no.) of UFD data block in which the 
name of this file appears 



A -Argument (supplied by privileged or nonpriviledged user program) and returned by monitor as 
a value. 

A0=Argument like A with the addition that a argument causes the monitor to substitute a 
default value. 

V=Value (returned by monitor) cannot be set even by privileged program, monitor ignores 

argument. 
Al =Argument if privileged program (ignored if nonprivileged). 
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The following explanation is a more complete description of the terms used in Table 6-6. 

.RBPPN LH=oclal project number (right-justijied) . 

RH =octal programmer number. 

The project-programmer number is of the UFD in which the file is to be 
LOOKedUP, ENTERed, or RENAMEd. To LOOKUP the MFD, .RBPPN 
must contain a 1 in the left half and a 1 in the right half indicating that 
the filename (.RBNAM) is to be LOOKedUP in project 1 , programmer l's 
UFD (the MFD) . 

.RBNAM SIXBIT filename, left justified with trailing nulls. If the MFD or UFD is 

being LOOKedUP, ENTERed, or RENAMEd, this location contains the 
project-programmer number. The argument can be only on a RENAME, 
in which case the file is deleted. If the filename is not left justified on 
ENTER, most programs are unsuccessful on a subsequent LOOKUP. The 
monitor cannot left-justify the argument because it may be an octal project- 
programmer number. 

.RBEXT LH =SIXBIT filename extension, left justified with (railing nulls. Null 

extensions are discouraged because they convey no information . If the 
extension is not left justified on ENTER, most programs are unsuccessful 
on a subsequent LOOKUP. RH , bits 24-35 =access date in standard 
format. If an error return is given, bits 18-35 are set to an error code 
by the monitor before the error (no skip) return is taken. 

. RBPRV Bits 0-8 =protection codes . 

Bits 9-12 =data mode in which file is created. 

Bits 13-23 =creation time in minutes since midnight. 

Bits 24-35 =creation date in standard format. 

.RBSIZ Written length of file. The word is the positive number of words written 

in the file. For extended arguments, this word is never used for project- 
programmer numbers . (The four-word block remains compatible so that 
LH =-number of words in file, RH=0.) This argument is ignored, and a 
value is always returned. 

.RBVER Octal version number like the contents of location 137 in the job data area. 

LH=patch level (A = l, B=2, etc.) 

Set by monitor except in the case of privileged programs . 

RH =octal version number, never converted to decimal . This argument 
is accepted, except on a LOOKUP. If a user program wishes to increase 
the version number by 1 on each UPDATE, it should add 1 to location 
E +6 between the LOOKUP and the ENTER. 

.RBFUT Reserved for the future . 

. RBEST Reserved for the future . 

.RBALC Number of 128-word blocks, N, to be allocated to the file, including 

both RIB blocks, after completion of ENTER or RENAME . 

A means do not change allocation rather than deallocate all the blocks 
of the file. All of the data blocks can be deallocated by superseding the 
file and doing no outputs before the CLOSE . This argument can be used 
to allocate additional space onto the end of the file, deallocate previously 
allocated but unwritten space, or truncate written data blocks. 
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.RBALC (Cont) 



.RBPOS 



.RBFT1 

.RBNCA 

.RBMTA 



.RBDEV 



.RBSTS 



The smallest unit of disk space that the monitor can allocate is a cluster 
of 128-word blocks . Typically small devices use a cluster size of 1 block. 
If N is not the last block of a cluster, the monitor rounds up, thereby 
adding a few more blocks than the user requested. 

Logical block number, L, of the first block to be allocated for a new 
group of clusters appended to the file. A logical block number is specified 
with respect to the entire file structure. Logical block numbers begin 
with logical block number 0. This feature combined with DSKCHR UUO 
allows a user program to allocate a file with respect to tracks and cylinders 
for maximum efficiency when Hie program runs alone. Because SAT blocks, 
swapping space, and bad blocks are scattered throughout a file structure, 
programs using this feature must be prepared to handle such contingencies. 
It is discouraged for any programs to depend on blocks actually used for 
allocation to operate without errors. 

Future nonprivileged argument reserved for DEC. 

Nonprivileged argument reserved for customer definition . 

A 36-bit tape label if file has been put on magnetic tape. If allocated 
space is 0, then file was deleted from disk when it was copied on magnetic 
tape. Argument is accepted only from privileged programs; otherwise, 
it is ignored. 

The logical name of the unit on which the file is located. Ignored as an 
argument, returned as a value. 

File status word 

LH =status of UFD . Bit = 1 if the user is logged in and is set by LOGIN. 

LOGOUT clears this bit. 

RH=statusof file. 

Bit 18 = 1 (.RPDIR) if file is a directory file; needed to protect the system 

from a user who might try to modify a directory file. 

Bit 19 = 1 (.RPNDL) if file cannot be deleted, even by a privileged program . 

Bit 20 = 1 (.RPNCN) if file cannot be renamed, even by a privileged program. 

Bit 21 =1 (.RPNFS) if file should not be dumped by FAILSAFE because certain 

files are needed before FAILSAFE can run. 

The following bits appear in both the LH and RH of this location: 

Bit 11 and bit 29 = 1 if any file in this UFD (or this file) has had a hard data 
error while reading . (The IODTER bit has been set.) An entry is made in 
the BAT block so that the bad region is not reused . 

Bit 10 and bit 28 = 1 if any file in this UFD (or this file) has had a hard data 
error while writing . (The IODTER bit has been set.) An entry is made in 
the BAT block so that the bad region is not reused . 

Bit 9 and bit 27 =1 if any file in this UFD (or this file) has had a software 
checksum error or redundancy check error. (The IOTMPM bit has been set.) 

NOTE 

Device errors (IODERR) are not flagged in the file 
status word because they refer to a device and dis- 
appear when a device is fixed . 
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.RBELB 



.RBEUN 



.RBQTF 



.RBQTO 



.RBQTR 



.RBUSD 



• RBAUT 



.RBNXT 
.RBPRD 
.RBPCA 
.RBUFD 



Logical block number within the unit on which last data error (IODTER) 
occurred, as opposed to block within file structure. Set by the monitor 
in the RIB on a CLOSE when the hardware detects either a hard bad parity 
error or two search errors while reading or writing the file. Device errors, 
checksum, and redundancy errors are not stored here. This argument is 
ignored, and a value is returned. 

LH =logical unit number within file structure on which last bad region 
was detected . 

RH =number of bad blocks in the last-detected bad region . The bad 
region may extend beyond the file. This argument is ignored, and a 
value is returned. 

Meaningful for UFD only. Contains first-come-first-served logged-in 
quota. This quota is the maximum number of data and RIB blocks that 
can be in this directory in this structure while the user is logged in. The 
UFD and its RIB are not counted . Argument is ignored unless it is from a 
privileged CUSP. 

Meaningful for UFD only. Contains logged-out quota. This quota is the 
maximum number of data and RIB blocks that can be left in this directory 
in this file structure after the user logs off. LOGOUT requires the user 
to be below this quota to log off. LOGIN stores these quotas in the RIB 
of the UFD, so that LOGOUT does not have to scan ACCT.SYS at 
LOGOUT time to find the quota. Argument is ignored unless it is from 
a privileged CUSP. 

Meaningful for UFD only. (In 5.02 monitors and later monitors.) Contains 
reserved logged-in quota. This quota is the guaranteed number of blocks 
the user has when he logs in . Argument is ignored unless it is from a 
privileged CUSP. 

Meaningful for UFD only. Contains number of data and RIB blocks used 
in this directory in this file structure by the user when he last logged off. 
LOGIN reads this word so that it does not have to LOOKUP all files 
in order to set up the number of blocks the user has written . LOGIN 
sets bit of the file status word (.RBSTS) and LOGOUT clears it in order 
to indicate whether LOGOUT has stored the quantity. Argument is 
ignored unless it is from a privileged CUSP. 

Contains project-programmer number of the creator or supersede- of the 
file, as opposed to owner of file. Usually the author and the owner 
are the same. Only when a file is created in a different directory are 
these different. This argument is used by Batch for validating queue 
entries in other directories. Argument is ignored unless it is from a 
privileged program. 

Reserved for future . 

Reserved for future. 

Privileged argument reserved for customer definition. 

The logical block number (not cluster number) in the file structure of the 
UFD's data block in which the name of this file appears. 
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6.2.8.3 Special Programmed Operator Service - The following are special programmed operator 

service UUOs. 

a. USETI and USETO UUOs - USETI D,A and USETO D,A are treated similarly by the 
disk service routines. Their function is to notify the service routine that a particular 
relative block is to be used on the next INPUT or OUTPUT on channel D (whichever 
occurs first). A designates a particular block relative to the beginning of the file. 
The only difference between USETI and USETO occurs when A is greater than the 
current size of the file (in blocks). On USETI, the monitor simply sets the IODEOF 
flag and returns, whereas on USETO, the monitor zeroes the intervening blocks and 
does not set the IODEOF flag. The next INPUT or IN causes the EOF flag to be set. 
The next OUTPUT or OUT writes the block at the appropriate place. On input, the 
RIB block is designated by A = 0. On output, A = returns the error bit IOBKTL. 

_ The first data block of the file (i .e., the one following the RIB) is designated by 

I A = 1 . If no previous LOOKUP or ENTER has been done, this UUO will set the 

improper mode error bit (IOIMPM). 

b. Super USETI and USETO UUOs - With disk packs, there is a need to read and write 
data without using a directory hierarchy (e.g. , for testing a pack in a timesharing 
environment or for a privileged recovery on any file structure). There must be a way 
to specify individual blocks of a file structure and/or unit without reference to any 
file. These blocks are called logical blocks because they must be transformed for 
the particular hardware before doing j/O. Under certain conditions, USETI and 
USETO are used to specify these logical blocks. When the following conditions 

are true, USETI and USETO reference logical block numbers with respect to a file 
structure instead of relative blocks within a file: 

(1) The channel is INITed with a file structure name. 

(2) No file is opened on the channel specified in the AC field. 

(3) The structure is a single-access structure assigned to the user, or the program is 
privileged. 

When the following conditions are true, USETI and USETO reference logical block 
numbers with respect to a unit instead of logical block numbers with respect to a 
file structure or relative blocks within a file: 

(1) The channel is INITed with a physical unit name. 

(2) No file is opened on the channel specified in the AC field. 

(3) The unit is a member of a single-access file structure mounted for the user, 
or the program is privileged. 

The terms super-USETI and super-USETO distinguish these UUOs from regular USETI 
and USETO. Super-USETI and super-USETO provide their arguments in the contents 
of the effective address, rather than the effective address itself. 

USETI and USETO and their counterparts do not perform I/O; they change either the 
current position of the file (regular) or the current position in the file structure (super). 
Both super-USETI and super-USETO set the IOBKTL flag if a specified logical block 
is too large for the file structure or unit. 

If a program is nonprivileged, super-USETI and super-USETO is a no-operation. 
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c . SEEK UUO - This UUO, when used in conjunction with USETI and USETO, allows 
user programs control over the time at which positioning operations occur. Follow- 
ing a regular USETI or USETO, positioning is to the cylinder containing the requested 
relative block within a file. Following a super-USETI or super-USETO, positioning 
is to the c/linder containing the specified disk block. 

The call is: 

CALL D, [SIXBIT/SEEK/] ; or CALLI D, 56 
return 

D specifies a software channel number. The SEEK UUOs are honored by the monitor 
only if the unit for which they are issued is idle. If the unit is in any other state, 
the SEEK UUO is a no-operation . 

SEEK UUOs issued for public file structures are treated in the same way as private 
file structures. This allows users to debug programs using a public disk pack and 
later run the same programs using a private disk pack . 

The following is proper UUO sequence for issuing a SEEK . 
For output 

(1) USETO to select a block (relative or actual) 

(2) SEEK to request positioning 

(3) computations 

(4) OUTPUT to request actual output 

For input 

(1) USETI to select a block (relative or actual) 

(2) SEEK to request positioning 

(3) computations 

(4) INPUT to request actual input. 

d. CALL tSIXBIT/ RESET/] - This UUO causes files that are in the process of being 
written, but have not been CLOSEd or RELEASed, to be deleted; the space is re- 
claimed. If a previous version of the file with the same name and extendsion 
existed, it remains unchanged on the disk (and in the UFD) . If the programmer 
wishes to retain the newly created file and to delete the older version, he must 
CLOSE or RELEASe the file before doing a RESET UUO . 

e. DEVSTS UUO - After each interrupt, FILSER stores the results of a CONI in the 
DEVSTS word of the device data block . The DEVSTS UUO is used to return the 
contents of the DEVSTS word to the user (refer to Paragraph 4.9.3.4) . 

f . CHKACC UUO - This UUO allows privileged programs to check the user's access to 
a particular file. The call is: 

MOVE AC, [EXP LOC] 

ACCESS AC, ;or CALLI AC, 100 

error return 

normal return 

The LH of LOC contains the code for the type of access to be checked and the RH 
of LOC contains a 9-bit protection field. If bits 27 through 35 are zero, then bits 
18 through 26 are interpreted as UFD privilege bits. LOC+1 contains the project- 
programmer number of the directory, and LOC+2 contains the project-programmer 
number of the user. 
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The type of access to be checked is represented by one of the following codes: 

Change protection, rename, write, update, append, read, 
execute. 

1 Rename, write, update, append, read, execute. 

2 Write, update, append, read, execute. 

3 Update, append, read, execute. 

4 Append, read, execute. 

5 Read, execute. 

6 Execute only. 

7 Create in UFD. 
10 Read UFD as a file. 

I The error return is given if the UUO is not implemented. On a normal return, AC 

contains if access is allowed or -1 if access is not allowed. 

6.2.8.4 Simultaneous Supersede and Update - Files that may be simultaneously superseded or updated 
by several different users should be treated with care. The problem arises when one user has a copy of 
information to be superseded by another user. For example; file F contains a count of the number of 
occurrences of a certain event. The count is 10 at a given time. When two users observe separate 
instances of the event, each tries to increment the count. 



Revision 1 Monitors 6-34a January 1971 



Supersede - Incorrectly 

Job 1 
LOOKUP A, F 

READ COUNT (=10) 
ADD I (=11) 

ENTER B, F 
WRITE OUT (=11) 
CLOSE B, F 



In this example, Job 2 ignored job 1 's increment. 

Supersede - Correctly 

Job 1 
ENTER B, F 
LOOKUP A, F 



INPUT A, (=10) 
ADD1 (=11) 
OUTPUT B, (=11) 
CLOSE B, F 



Job 2 



LOOKUP C, F 
READ COUNT (=10) 
ADD 1 (=11) 



ENTER D, F 

ENTER D, F 
WRITE OUT (=11) 
CLOSED, F 



Job 2 



ENTER D, F 
LOOKUP C, F 



ENTER D, F 
INPUT C, (=11) 
ADD1 (=12) 
OUTPUT D, (=12) 
CLOSED, F 



(Fail) 
(Succeed) 



(Fail) 



(Succeed) 



In this example, both jobs performed the ENTER FIRST; therefore, incorrect copies were not made and 
the increment of each [ob was recorded properly. 



The similar problem with a update can be avoided by never using the information returned by the 
LOOKUP: 



Job 1 

LOOKUP A, F 
INPUT A, 

ENTER A, F 

OUTPUT 

CLOSE 



Job 2 

LOOKUP B, F 
INPUT B, 

ENTER B, F 
Here any information 
from the LOOKUP and 
INPUT must be discarded. 



(Fail) 
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6.2.9 File Status (refer to Appendix D) 
The file status of the disk is shown below , 



18 21 24 27 30 33 35 



SET BY USER 



18 



SET BY MONITOR 



Bit 18 - IOIMPM 



Bit 19- IODERR 
Bit 20- IODTER 

Bit 21 - IOBKTL 



Bit 22 - IODEOF 



Bit 23 - IOACT 



a. INPUT UUO attempted on a read-protected file 

b. INPUT UUO when no LOOKUP was done (or 
super-USETl/USETO previously attempted by 
nonprivileged user) 

c . OUTPUT UUO when no ENTER was done (or 
super-USETl/USETO previously attempted by 
nonprivileged user) 

d. Software-detected checksum error 

e. Software-detected redundancy error in SAT block 
or RIB, or (6)buffered mode I/O attempted after 
super-USETl/USETO. 

Search error, power supply failure. 

Disk or data channel parity error. 
Checksum failure on INPUT. 

a . Quota is exhausted (past overdrawn) 

b. File structure is exhausted 

c. RIB is full 

d . Super-USETl/USETO block is too large for the file 
structure 

e. More than 777777 blocks were read with one super- 
USETI/USETO. 

EOF encountered on INPUT. No special character appears in 
the buffer. 

Device is active 



18 21 24 27 30 33 35 



UNUSED 



There are no device dependent bits. 
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6.2.10 Disk Packs 

A disk pack system combines disk and me DECtape features. Some packs (similar to individual DEC- 
tapes) are designed to be private, assignable, and removable. The other packs make up part or all of 
the public disk storage area where CUSPs and user files are stored. These disk packs belong to file 
structures in the storage pool and cannot be assigned to any single user. The system library and shared 
on-line storage is maintained and swapping storage is assigned within the public disk pack area. 

The most important distinction between public and private packs is that private packs are intended to 
be removed from the system during regular operation . Public packs stay on-line all the time. How- 
ever, the file structure format for public and private disk packs is identical . 

User programs can exercise much greater control over private packs. For example; a program may 
attempt to position the arms of disk packs in anticipation of future I/O (refer to Paragraph 6.2.8.3c). 
This capability is useful to a program that is aware of the contents of a disk and is able to use this 
information to optimize positioning . The program may also specify the position of files on the disk by 
using the allocate arguments of the extended LOOKUP, ENTER, and RENAME UUOs. 

Private packs may be accessed by more than one job (multi -access) or restricted to only one job (single 
access) . To access a private file structure, the user must type the MOUNT command (available In 
5.02 monitors and later monitors). If the private file structure is already mounted, on-line, and multi- 
access, the user receives an immediate response and may start using the private pack . When the user 
is finished using the private file structure, he should type the REMOVE command . If no other job is 
using the file structure, a message is typed to the operator informing him that the drives belonging to 
the file structure are free. 

6.2.10.1 Removable File Structures - All file structures are designed as if they could be removed from 
the system; therefore, disk packs are handled the same as other types of disks . 

6.2.10.2 Identification - Disk packs have identifying information written on the home block, a 
block on every unit identifying the file structure to which the unit belongs and its position within the 
file structure. Part of this information is the pack ID, a one- to six-character SIXBIT name uniquely 
identifying Hie disk pack . The MOUNT and OMOUNT CUSPs check that the operator has mounted 
the proper packs by comparing the pack ID in the home block with the information stored in the system 
administration file STRLST.SYS. 
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6.2 .10.3 IBM Disk Pack Compatibility - The data format of IBM disk packs has variable-length 
sectors and no sector headers. DEC format has fixed-length sectors (128 words) and specially written 
sector headers. Latency optimization is employed to improve system throughput (refer to Paragraph 7.3). 
DEC's significantly simpler hardware controller is used without reducing user capabilities. 

To transfer data from a IBM pack system to a DEC pack system, a simple program in a higher-level 
language should be written for both machines. The program then reads the IBM disk pack on the IBM 
computer and writes the files onto magnetic tape. The magnetic tape is then transferred to a DEC 
computer and read by another program, which writes the files onto the DEC RP01 or RP02 packs. 
6.3 SPOOLING OF UNIT RECORD l/O ON DISK 

Devices capable of spooling (card reader, line printer, card punch, paper-tape punch, and plotter) 
have an associated bit in the job's JBTSPL word. If this bit is on when the device is ASSIGNed or 
INITed, the device is said to be in spool mode. While in this mode, all I/O for this device is inter- 
cepted and written on the disk rather than to the device. System spooling programs later do the actual 
I/O transfer to the device. 

Spooling allows more efficient use of the device because users cannot tie it up indefinitely. In addition, 
since the spooling devices are generally slow and the Jobs that are to be spooled are usually large, the 
jobs do not spend unnecessary time in core. 

6.3.1 Input Spool ing 

If a LOOKUP is given after the INIT of the card reader, it is ignored and an automatic LOOKUP is 
done, using the filename given in the last SET CDR command and the filename extension of .CDR. 
After every automatic LOOKUP, the name in the input-name counter JBTSPL is incremented by 1 so 
that the next automatic LOOKUP will use the correct filename. 

6.3.2 Output Spooling 

If an ENTER is done, the filename specified is stored in the RIB so that the output spooler can label 
the output. Therefore, programs should give a filename if they can. 

If an ENTER is not done, an automatic ENTER is given, using a filename in the general form 
xxxyyy.zzz 

where xxx is a three-character name manufactured by the monitor to make the 

9-character name unique . 

yyy is (1) an appropriate station number Snn if a generic device name is 
INITed or (2) a unit number if a specific unit is INITed. 

zzz is the generic name of the device-type (LPT, CDP, PTP, or PLT). 

Output spooling should not concern the user because all requests are queued when the user logs off the 
system. The files are moved to the output queues before the logged-out quota is computed. 
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Chapter 7 
Monitor Algorithms 



7.1 JOB SCHEDULING 

The number of jobs that may be run simultaneously must be specified in creating a PDP-10 Timesharing 
Monitor. Up to 127 jobs may be specified. Each user accessing the system is assigned a job number. 

In a multiprogramming system all jobs reside in core, and the scheduler decides what jobs should run. 
In a swapping system, jobs exist on an external storage device (usually disk or drum) as well as in core. 
The scheduler decides not only what job is to run but also when a job is to be swapped out onto the 
disk (drum) or brought back into core. 

In a swapping system, jobs are retained in queues of varying priorities that reflect the status of the 
jobs at any given moment. Each job number possible in the system resides in only one queue at any 
time. A job may be in one of the following queues: 

a. Run queues - for runnable jobs waiting to execute. (There are three run queues of 
different levels of priorities.) 

b. I/O wait queue - for jobs waiting while doing I/O. 

c. I/O wait satisfied queue - for jobs waiting to run after finishing I/O. 

d. Sharable device wait queue - for jobs waiting to use sharable devices. 

e. Teletype wait queue - for jobs waiting for input or output on the user's console. 

f . Teletype wait satisfied queue - for jobs that completed a Teletype operation and 
are awaiting action. 

g. Stop queue - for processes that have been completed or aborted by an error and 
are awaiting a new command for further action. 

h. Null queue - for all job numbers that are inactive (unassigned). 

Each queue is addressed through a table. The position of a queue address in a table represents the 
priority of the queue with respect to the other queues. Within each queue, the position of a job 
determines its priority with respect to the other jobs in the same queue. The status of a job is changed 
when it is placed in a different queue. 
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Each job, when it is assigned to run, is given a quantum time. When the quantum time expires, the 
job ceases to run and moves to a lower priority run queue. The activities of the job currently running 
may cause it to move out of the run queue and enter one of the wait queues. For example: when a 
currently running job begins input from a DECfape, it is placed in the I/O wait queue, and the input 
is begun. A second job is set to run while the input of the first job proceeds. If the second job then 
decides to access a DECtape for an I/O operation, it is stopped because the DECtape control is busy, 
and it is put in the queue for jobs waiting to access the DECtape control. A third job is set to run. 
The input operation of the first job finishes, making the DECtape control available to the second job. 
The I/O operation of the second job is initiated, and the job is transferred from the device wait queue 
to the I/O wait queue. The first job is transferred from the I/O wait queue to the highest priority run 
queue. This permits the first job to preempt the running of the third job. When the quantum time of 
the first job becomes zero, it is moved into the second run queue, and the third job runs again until 
the second job completes its I/O operations. 

Data transfers also use the scheduler to permit the user to overlap computation with data transmission. 
In unbuffered modes, the user supplies an address of a command list containing pointers to relative 
locations in the user area to and from which data is to be transferred. When the transfer is initiated, 
the job is scheduled into an I/O wait queue where it remains until the device signals the scheduler 
that the entire transfer has been completed. 

In buffered modes, each buffer contains a use bit to prevent the user and the device from using the same 
buffer at the same time (refer to Paragraph 4. 10.3). If the user overtakes the device and requires the 
buffer currently being used by the device as his next buffer, the user's job is scheduled into an I/O 
wait queue. When the device finishes using the buffer, the device calls the scheduler to reactivate 
the job. If the device overtakes the user, the device is stopped at the end of the buffer and is re- 
started when the user finishes with the buffer. 

Scheduling occurs at each clock tick (l/60th or 1/50th or a second) or may be forced at monitor level 
between clock ticks if the current job becomes blocked (unrunnable). The asynchronous swapping 
algorithm is also called at each clock tick and has the task of bringing a job from disk into core. This 
function depends on 

a. The core shuffling routine, which consolidates unused areas in core to make sufficient 
room for the incoming job 

b. The swapper, which creates additional room in core by transferring jobs from 
core to disk. 

Therefore, when the scheduler is selecting the next job to be run, the swapper is bringing the next job 
to be run into core. The transfer from disk to core takes place while the central processor continues 
computation for the previous job. 
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7.2 PROGRAM SWAPPING 

Program swapping is performed by the monitor on one or more units of the system independent of the 
file structures that may also use the units. Swapping space is allocated and deallocated in clusters of 
IK words (exactly); this size is the increment size of the memory relocation and protection mechanism. 
Directories are not maintained, and retrieval information is retained in core. Most user segments are 
written onto the swapping units as contiguous units. Swapping time and retrieval information is, there- 
fore, minimized. Segments are always read completely from the swapping unit into core with one I/O 
operation. The swapping space on all units appears as a single system file, SWAP. SYS, in directory 
SYS in each file structure. This file is protected from all but privileged programs by the standard file 
protection mechanism (refer to Paragraph 6.2.3). 

The reentrant capability reduces the demands on core memory, swapping space, swapping channel, and 
storage channel; however, to reduce the use of the storage channel, copies of sharable segments are 
kept on the swapping device. This increases the demand for swapping space. To prevent the swapping 
space from being filled by user's files and to keep swapped segments from being fragmented, swapping 
space is preal located when the file structure is refreshed. The monitor dynamically achieves the space- 
time balance by assuming that there is no shortage of swapping space. Swapping space is never used 
for anything except swapped segments, and the monitor keeps a single copy of as many segments as 
possible in this space. (The maximum number of segments that may be kept may be increased by 
individual installations but is always at least as great as the number of jobs plus one.) If a sharable 
segment on the swapping space is currently unused, it is called a dormant segment. An idle segment 
is a sharable segment that is not used by users in core; however, at least one swapped-out user must 
be using the segment or it would be a dormant segment. 

Swapping disregards the grouping of similar units into file structures; therefore, swapping is done on a 
unit basis rather than a file structure basis. The units for swapping are grouped in a sorted order, re- 
ferred to as the active swapping list . The total virtual core, which the system can allocate to users, 
is equal to the total swapping space preallocated on all units in the active swapping list. In computing 
virtual core, sharable segments count only once, and dormant segments do not count at all. The 
monitor does not allow more virtual core to be granted than the system has capacity to handle. 

When the system is started, the monitor reads the home blocks on all the units that it was generated to 
handle. The monitor determines from the home blocks which units are members of the active swapping 
list. This list may be changed at once-only time. The change does not require refreshing of the file 
structures, as long as swapping space was preallocated on the units when they were refreshed. All of 
the units with swapping space allocated need not appear in the active swapping list. For example: a 
drum and disk pack system should have swapping space allocated on both drum and disk packs. Then, 
if the drum becomes inoperable, the disk packs may be used for swapping without refreshing. 
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Users cannot proceed when virtual core is exhausted; therefore, FILSER is designed to handle a variety 
of disks as swapping media. The system administrator allocates additional swapping space on slower 
disks and virtually eliminates the possibility of exhausting virtual core; therefore, in periods of heavy 
demand, swapping is slower for segments that must be swapped on the slower devices. It is also un- 
desirable to allow dormant segments to take up space on high-speed units. This forces either fragmen- 
tation on fast units or swapping on slow units; therefore, the allocation of swapping space is important 
to overall system efficiency. 

The swapping allocator is responsible for assigning space for the segment the swapper wants to swap 
out. It must decide 

a. Onto which unit to swap the segment 

b. Whether to fragment the unit if not enough contiguous space is available 

c. Whether to make room by deleting a dormant segment 

d. Whether to use a slower unit. 

The units in the active swapping list are divided into swapping classes, usually according to device 
speed. For simplicity, the monitor assumes that all the units of class are first followed by all the 
units of class 1 . Swapping classes are defined when the file structures are refreshed, and may be 
changed at once-only time. 

When attempting to allocate space to swap out a low or high segment, the monitor performs the 
following: 

Step Procedure 

1 The monitor looks for contiguous space on one of the units of 
the first swapping class. 

2 The monitor looks for noncontiguous space on one of the units 
in the same class. 

3 The monitor checks whether deleting one or more dormant 
segments would yield enough contiguous or noncontiguous 
space. 

If all of these measures fail, the monitor repeats the process on the next swapping class in the active 
swapping list. If none of the classes yield enough space, the swapper begins again and deletes 
enough dormant segments to fragment the segment across units and classes. When a deleted segment is 
needed again, it is retrieved from the storage device. 
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7.3 DEVICE OPTIMIZATION 

7.3.1 Concepts 

Each I/O operation on a unit consists of two steps: positioning and data transferring. To perform I/O, 
the unit must be positioned, unless it is already on a cylinder or is a non-positioning device. To posi- 
tion a unit, the controller cannot be performing a data transfer. If the controller is engaged in a data 
transfer, the positioning operation of moving the arm to the desired cylinder cannot begin until the 
data transfer is complete. 

The controller ensures that the arms have actually moved to the correct cylinder. This check is called 
verification , and the time required is fixed by hardware. If verification fails, the controller interrupts 
the processor, and the software recalibrates the positioner by moving it to a fixed place and beginning 
again. When verification is complete, the controller reads the sector headers to find the proper sector 
on which to perform the operation. This operation is called searching. Finally, the data is transferred 
to or from the desired sectors. To understand the optimization, the transfer operation includes verifi- 
cation, searching, and actual transfer. The time from the initiation of the transfer operation to the 
actual beginning of the transfer is called the latency time. The channel is busy with the controller for 
the entire transfer time; therefore, it is important for the software to minimize the latency time. 

The FILSER code, a routine that queues disk requests and makes optimization decisions, handles any 
number of channels and controllers and up to eight units for each controller. Optimization is designed 
to keep: 

a. As many channels as possible performing data transfers at the same time. 

b. As many units positioning on all controllers, which are not already in position for 
a data transfer. 

Several constraints are imposed by the hardware. A channel can handle only one data transfer on one 
control at a time. Furthermore, the control can handle a data transfer on only one of its units at a 
time. However, the other units on the control can be positioning while a data transfer is taking place 
provided the positioning commands were issued prior to the data transfer. Positioning requests for a 
unit on a controller, which is busy doing a data transfer for another of its units, must be queued until 
the data transfer is finished. When a positioning command is given to a unit through a controller, the 
controller is busy for only a few microseconds; therefore, the software can issue a number of positioning 
commands to different units as soon as a data transfer is complete. All units have only positioning 
mechanism that reaches each point; therefore, only one positioning op. - ion can be performed on a 
unit at the same time. All other positioning requests for a unit must be queued. 

The software keeps a state code in memory for each active file, unit, controller, and channel, to 
remember the status of the hardware. Reliability is increased because the software does not depend on 
the status information of the hardware. The state of a unit is as follows: 
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I Idle; No positions or transfers waiting or being performed. 

SW Seek Wait; Unit is waiting for control to become idle so that 

it can initiate positioning (refer to Paragraph 6.2). 

S Seek; Unit is positioning in response to a SEEK UUO; no transfer 

of data follows. 

PW Position Wait; Unit is waiting for control to become idle so that 

if can initiate positioning. 

P Position; Unit is positioning; transfer of data follows although not 

necessarily on this controller. 

TW Transfer Wait; Unit is in position and is waiting for the controller/ 

channel to become idle so that if can transfer data. 

T Transfer; Unit is transferring; the controller and channel are busy 

performing the operation. 



Table 7-1 lists the possible states for files, units, controllers, and channels. 



Table 7-1 
Software States 



File* 


Unit 


Controller 


Channel 


I 

PW 
P 

TW 
T 


I 

SW 

S 

PW 

p 

TW 
T 


I 
T 


I 
T 


Cannot be in S or SW state because SEEKs 
are ignored if the unit is not idle. 



7.3.2 Queuing Strategy 

When an I/O request for a unit is made by a user program because of an INPUT or OUTPUT UUO, one 
of several things can happen at UUO level before control is returned to the buffer-strategy module in 
UUOCON, which may, in turn, pass control back to the user without rescheduling. If an I/O request 
requires positioning of the unit, either the request is added to the end of the position-wait queue for 
the unit if the control or unit is busy, or the positioning is initiated immediately. If the request does 
not require positioning, the data is transferred immediately. If the channel is busy, the request is 
added to the end of the transfer-wait queue for the channel . The control gives the processor an inter- 
rupt after each phase is completed. Optimization occurs at interrupt level when a position-done or 
transfer-done interrupt occurs. 
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7.3.2.1 Position-Done Interrupt Optimization - The following action occurs only if a transfer-done 
interrupt does not occur first. Data transfer is started on the unit unless the channel is busy transfer- 
ring data for some other unit or control . If the channel is busy, the request goes to the end of the 
transfer-wait queue for that channel . 

7.3.2.2 Transfer-Done Interrupt Optimization - When a transfer-done interrupt occurs, all the 
position-done interrupts inhibited during the data transfer are processed for the controller, and the 
requests are placed at the end of the transfer-wait queue for the channel . All units on the controller 
are then scanned. The requests in the position-wait queues on each unit are scanned to see the re- 
quest nearest the current cylinder. Positioning is begun on the unit of the selected request. All re- 
quests in the transfer-wait queue for all units on the channel that caused the interrupt are then scanned 
and the latency time is measured. The request with the shortest latency time is selected, and the new 
transfer begins. 

7.3.3 Fairness Considerations 

When the system selects the best task to run, users making requests to distant parts of the disk may not 
be serviced for a long time. The disk software is designed to make a fair decision for a fixed percent- 
age of time. Every n decisions the disk software selects the request at the front of the position-wait 
or transfer-wait queue and processes it, because that request has been waiting the longest. The value 
of n is set to 10 (decimal) and may be changed by redefining symbols with MONGEN (see 
MONITR.OPR). 

7.3.4 Channel Command Chaining 

7.3.4.1 Buffered Mode - Disk accesses are reduced by using the chaining feature of the data chan- 
nel . Prior to reading a block in buffered mode, the device independent routine checks to see if there 
is another empty buffer, and if the next relative block within the file is a consecutive logical block 
within the unit. If both checks are true, FILSER creates a command list to read two or more consecu- 
tive blocks into scattered core buffers. Corresponding decisions are made when writing data in buffer- 
ed mode, and, if possible, two or more separate buffers are written in one operation. The command 
chaining decision is not made when a request is put into a position-wait or transfer-wait queue; 
instead, it is postponed until the operation is performed, thus increasing the chances that the user 
program will have more buffers available for input or output. 

7.3.4.2 Unbuffered Mode - Unbuffered modes do not use channel chaining, and therefore, read or 
write one command word at a time. Each command word begins at the beginning of a 128-word block. 
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If a command word does not contain an even multiple of 128 words, the remaining words of the last 
block are not read, if reading, and are written with zeroes, if writing . 

7.4 MONITOR ERROR HANDLING 

The monitor detects a number of errors. If a hardware error is detected, the monitor repeats the 

I operation ten times. If the failure occurs eleven times in a row, it is classified as a hard error . If the 
operation succeeds after failing one to ten times, it is a soft error . 

7.4.1 Hardware Detected Errors 

Hardware detected errors are classified either as device errors or as data errors. A device error indi- 
cates a malfunction of the controller or channel . A data error indicates that the hardware parity did 
not check or a search for a sector header either did not succeed or had bad parity (the user's data is 
probably bad) . 

A device error sets the IODERR bit in the channel status word, and a data error sets the IODTER bit. 

Disk units may have imperfect surfaces; therefore, a special non-timesharing diagnostic program, MAP, 
is provided to initially find all the bad blocks on a specified unit. The logical disk addresses of any 
bad regions of one or more bad blocks are recorded in the bad allocation table (BAT) block on the unit. 
The timesharing monitor allocates all storage for files; therefore, it uses the BAT block to avoid allo- 
cating blocks that have previously proven bad. The MAP program writes two copies of the BAT block 
because the BAT block might be destroyed. If the MAP program is not used, the monitor discovers the 
bad regions when it tries to use them and adds this information to the BAT block. However, the first 
user of the bad region loses that part of his data. 

A hard data error usually indicates a bad surface; therefore, the monitor never returns the bad region 
to free storage. This results in the bad region causing an error only once. The bad unit and the logi- 
cal disk address are stored in the retrieval information block (RIB) of the file when the file is CLOSEd 
or RESET and the extent of the bad region is determined. The origin and length of the bad region is 
stored in the bad allocation table (BAT) block. 

7.4.2 Software Detected Errors 

The monitor makes a number of software checks on itself. It checks the folded checksum (refer to 
Appendix I) computed for the first word of every group and stored in the retrieval pointer. The monitor 
also checks for inconsistencies when comparing locations in the retrieval information block with ex- 
pected values (filename, filename extension, project-programmer number, special code, logical block 
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number). The monitor checks for inconsistencies in the storage allocation table block when comparing 
the number of free clusters expected with the number of zeroes. A checksum error or an inconsistency 
error in the SAT block or RIB normally indicates that the monitor is reading the wrong block. When 
these errors occur, the monitor sets the improper mode error bit (IOIMPM) in the user channel status 
word and returns control to the user program . 

7.5 DIRECTORIES 

7.5.1 Order of Filenames 

The names of newly created files are appended to the directory if the directory does not contain more 
than 64 filenames. If the directory contains more than 64 filenames, a second block is used for the 
new filenames. When filenames are deleted from the first block, entries from the second block are not 
moved into the first. When additional new files are created, their names are added to the end of the 
first block of the directory instead of the end of the directory. Thus, the order of the filenames in 
the directory may not be according to the date of creation. 

7.5.2 Directory Searches 

Table space in core memory is used to reduce directory searching times. The JBTPPB table contains 
pointers to a list of four-word blocks for the user's project-programmer number, one block for each 
file structure on which the user has a UFD. 

Four-word name and access blocks contain copies of LOOKUP information for recently-accessed files 
and may reduce disk accesses to one directory read for a LOOKUP on a recently-active file. Recent 
LOOKUP failures are also kept in core, but are deleted when space is needed. 

7.6 PRIORITY INTERRUPT ROUTINES 

7.6.1 Channel Interrupt Routines 

Each of the seven PI channels has two absolute locations associated with it in memory: 40+2n and 
41+2n, where n is a channel number (1-7). When an interrupt occurs on a channel , control is immedi- 
ately transferred to the first of the two associated locations (unless an interrupt on a higher priority 
channel is being processed). For fast service of a single device, the first location contains either a 
BLKI or BLKO instruction. For service of more than one device on the same channel , the first location 
contains a JSR to location CHn in the appropriate channel interrupt routine. The JSR ensures that the 
current state of the program counter is saved . 
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Each channel interrupt routine (mnemonic name, CHANn, where n is the channel number) consists of 
three separate routines: 



CHn: 



SAVCHn: 



XITCHn: 



The contents of the program counter is saved in location 
CHn. CHn+1 contains a JRST to the first device service 
routine in the interrupt chain. 

The routine to save the contents of a specified number of 
accumulators. It is called from the device service routines 
with a JSR. 

The routine to restore saved accumulators. Device service 
routines exit to XITCHn with a POPJ PDP, if SAVCHn was 
previously called. 



7.6.2 Interrupt Chains 

Each device routine contains a device interrupt routine DEVINT where DEV is the three-letter 
mnemonic for the device concerned. This routine checks to determine whether an interrupt was 
caused by device DEV. The interrupt chain of a given channel is a designation for the logical posi- 
tioning of each device interrupt routine associated with that channel . 

The monitor flow of control on the interrupt level through a chain is illustrated below. Channel 5 is 
used in the example. 

Explanation 

;control transferred here 
;on interrupt 



;contents of PC saved here 
;control transfers to first 
; I ink in interrupt chain 

;if PTPdone bit is 
;on, PTP was cause 
; of interrupt - 
;otherwise, go to 
;next device. 



Monitor Routine 


Relevant Code 


Absolute 
Locations 


52/JSR CH5 
53/ 

1 


CHAN5 


CH5: 

JRST PTPINT 

1 


PTPSER 


PTPINT: CONSO PTP,PTPDON 
JRST LPTINT 



I 



LPTSER 



LPTINT: CONSO LPT, LPTLOV+LPTERR+LPTDON 

JEN @ CH5 ;three possible bits 

;may indicate that 
;LPT caused interrupt 



When a real-time device is added to the interrupt chain (CONSO skip chain) by a RTTRP UUO (refer 
to Paragraph 8.3), the device is added to the front of the chain. After putting a real-time device on 
Channel 5 in single mode (refer to Paragraph 8.3), the chain is as follows: 
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Monitor Routine 


Relevant Code 


Absolute 
Locations 


52/JSRCH5 
53/ 

I 


CHAN5 


CH5:0 

JRST RDTINT 

1 


RTDEV 


RTDINT: CONSO RTD,BITS 
JRST PTPINT 

JRST <context switcher and 
dispatch for real-time 
interrupts > 



PTPSER 



LPTSER 



PTPINT: CONSO PTP,PTPDON 
JRST LPTINT 



I 



Explanation 

;control transferred here 
on interrupt 

; contents of PC saved here 
; control transfers to first 
;l ink in interrupt chain 



;if PTPdone bit is 
;on, PTP was cause 
;of interrupt - 
;otherwise, go to 
;next device. 



LPTINT:CONSO LPT, LPTLOV+LPTERR-H.PTDON 

JEN @ CH5 ;three possible bits 

;may indicate that 
'. ;LPT caused interrupt 



After putting a real-time device on channel 5 in normal block mode (refer to Paragraph 8.3), the 
chain is as follows: 

Explanation 

;control transferred here 
on interrupt 

; contents of PC saved here 
;control transfers to first 
;[ ink in interrupt chain 



Monitor Routine 


Relevant Code 


Absolute 
Locations 


52/JSRCH5 
53/ 

1 


CHAN5 


CH5:0 

JRST RTDINT 

J 



RTDEV 



PTPSER 



LPTSER 



RTDINT:CONSO RTD,BITS 
JRST PTPINT 
BLKI RTD,POINTR 
JRST Context switcher > 
JEN@CH5 

PTPINT: CONSO PTP,PTPDON ;if PTP done bit is 

JRST LPTINT ;on, PTP was cause 

;of interrupt - 
1 ;otherwise, go to 

1 ;next device. 

LPTINT:CONSO LPT, LPTLOV-H.PTERR-H.PTDON 

JEN @ CH5 ;three possible bits 

;may indicate that 
• ;LPT caused interrupt. 
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Chapter 8 

Real— Time Programming 



Privileged jobs may for various reasons desire to be locked in core, that is, to never be considered 
for swapping or shuffling. Some examples of these jobs are as follows: 

Real-time jobs These jobs require immediate access to the processor in response 

to an interrupt from an I/O device. 

Display jobs The display must be refreshed from a display buffer in the user's 

core area in order to keep the display picture flicker-free. 

Batch Batch throughput may be enhanced by locking the Batch control 

CUSP in core. 

Performance analysis Jobs monitoring the activities of the system need to be locked in 

core so that when they are entered to gather data, they are aware 
of their state and therefore, can record activities of the monitor 
independent of the monitor. 



8.1 DEFINITIONS 

In swapping and non-swapping systems, unlocked jobs can occupy only the physical core not occupied 
by locked jobs. Therefore, locked jobs and timesharing jobs contend with one another for physical 
core memory. In order to control this contention, the system manager is provided with a number of 
system parameters as described below. 

Total User Core is the physical core which can be used for locked and unlocked jobs. This value is 
equal to total physical core minus the monitor size. 

CORMIN is the guaranteed amount of contiguous core which a single unlocked job can have. This 
value is a constant system parameter and is defined by the system manager at monitor generation time 
using MONGEN. It can be changed at monitor startup time using the ONCE ONLY dialogue. This 
value can range from to Total User Core. 

CORMAX is the largest contiguous size that an unlocked job can be. It is a time-varying system 
parameter and is reduced from its initial setting as jobs are locked in core. In order to satisfy the 
guaranteed size of CORMIN, the monitor never allows a job to be locked in core if this action would 
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result in CORMAX becoming less than CORMIN. The initial setting of CORMAX is defined at 
monitor generation time using MONGEN and can be changed at monitor startup time using the 
ONCE ONLY dialogue. CORMAX can range from CORMIN to Total User Core. A guaranteed 
amount of core available for locked jobs can be made by setting the initial value of CORMAX to 
less than Total User Core. 

8.2 LOCK AC, OR CALLI AC,60 

I This UUO provides a mechanism for locking Jobs in user memory. The user may specify if the high 
segment, low segment, or both segments are to be locked. When this UUO is executed by a privileged 
user program (privileges are granted by the system manager), it results in the job being locked in the 
optimal position in memory (at an extremity of user core). 

A Job may be locked in core if all of the following are true: 

a. The job is privileged (privileges set from the accounting file ACCT.SYS by LOGIN). 

b. The job, when locked, would not prevent another fob from expanding to the guaranteed 
limit, CORMIN. 

c. The fob, when locked, would not prevent an existing job from running. Note that un- 
locked fobs can exceed CORMIN. 

The call is: 

MOVSI AC,1 ; if high segment is to be locked 

MOVSI AC,0 ;if no high segment or if high 

;segment is not to be locked 

HRRI AC, 1 ;if low segment is to be locked 

HRRI AC, ;if low segment is not to be locked 

LOCK AC, ; or CALLI AC,60 

error return ;AC contains an error code 
normal return 

On a normal return, the fob is locked in core. If there is a high segment, the LH of AC contains its 
absolute address, shifted right nine bits. If there is no high segment, the LH of AC contains zero. The 
RH of AC contains the absolute address of the low segment, shifted right nine bits. 

On an error return, the fob is not locked in core and AC contains an error code indicating the condi- 
tion that prevented the fob from being locked. The error codes are as follows: 

Error Code Explanation 

1 The job does not have locking privileges. 

2 If the fob were locked in core, it would 
not be possible to run the largest existing 
non-locked fob. (Applies only to swap- 
ping systems.) 

3 If the fob were locked in core, it would not 
be possible to meet the guaranteed largest 
size for an unlocked fob, that is, CORMAX 
would be less than CORMIN. 
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NOTE 

The COR UUO may be given for the high or low segment 
of a locked job if the segment is not locked in core. When 
the segment is locked in core, the COR UUO and the CORE 
command with a non-zero argument cannot be satisfied and, 
therefore, always give an erroneous response. The program 
should determine the amount of core needed for the exe- 
cution and request this amount before executing the LOCK 
UUO. 

Although memory fragmentation is minimized by both the LOCK UUO and the shuffler, the locking 
algorithm alwaysallows Job locking, even though severe fragmentation may take place, as long js 

1) all existing jobs can continue to run, and 

2) at least CORMIN is available as a contiguous space (see Figure 8-1E). 

Therefore, it is important that system managers use caution when granting locking privileges. The 
following are guidelines for minimizing fragmentation when using the LOCK UUO. 



8.2.1 Non-Swapping Systems 

a. Any number of jobs can be locked in core without fragmentation occurring if the jobs are 
initiated immediately after the monitor is loaded. 

b. During normal timesharing, a job is locked at the top of user core if the hole at the top 
of core is large enough to contain the job. Otherwise, the job is locked as low in core 
as possible. 

c. Locking a job in core never makes the system fail , but it is possible that all of available 
core will not be utilized in some mixes of jobs. 



8.2.2 Swapping Systems 

a. There is no memory fragmentation if no more than two jobs are locked in core. 

b. There is no fragmentation if the locked jobs do not relinquish their locked status (i.e., no 
job terminates that has issued a LOCK UUO). In general, jobs with locking privileges 
should be production jobs. 

c. If a job issuing a LOCK UUO is to be debugged and production jobs with locking privileges 
are to be run, the job to be debugged should be initiated and locked in core first, since 

it will be locked at the top of core. Then, the production jobs should be initiated since 
they will all be locked at the bottom of core. This procedure reserves the space at the 
top of core for the job being debugged and guarantees that there is no fragmentation as it 
locks and unlocks. 

d. With a suitable setting of CORMIN and the initial setting of CORMAX in relation to Total 
User Core, the system manager can establish a policy viiich guarantees 

1) a maximum size for any unlocked job (CORMIN), 

2) a minimum amount of total lockable core for all jobs (Total User Core - CORMAX), 
and 
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3) the amount of core which locked ond unlocked fobs can content for on a first-come- 
first-serve basis (Total User Core - initial CORMAX + CORMIN). 

8.2.3 Core Allocation Resource 

Since the routines that lock jobs in core use the swapping and core allocation routines, they are 
considered a shamble resource. This resource is the semipermanent core allocation resource 
(mnemonic=CA). When a fob issues a LOCK UUO and the system is currently engaged in executing 
a LOCK UUO for another Job, the fob enters the queue associated with the core allocation resource. 
Since a fob may share a queue with other jobs and since swapping and shuffling may be required to 
position the job to where it is to be locked, the actual execution time needed to complete the process 
of locking a fob might be on the order of seconds. 

When it has been established that a job can be locked, the low segment number and the high segment 
number (if any) are stored as flags to activate the locking routines when the swapper and shuffler are 
idle. The ideal position for the locked job is also stored as a goal for the locking routines. In swap- 
ping systems, the ideal position is always achieved guaranteeing minimum fragmentation. In non- 
swapping systems, minimum fragmentation is achieved only if the ideal position does not contain an 
active segment (see Figure 8-1). 

In swapping systems, after the fob is locked in core, the locking routine determines the size of the 
new largest contiguous region available to unlocked fobs. This value will be greater or equal to 
CORMIN. If this region is less than the old value of CORMAX, then CORMAX is set equal to the 
size of the new reduced region. Otherwise, CORMAX remains set to its old value. 

8.2.4 Unlocking Jobs 

A fob relinquishes its locked status when either the user program executes a EXIT or RESET UUO, or 
the monitor performs an implicit RESET for the user. Implicit RESETs occur when 

a. The user program issues a RUN UUO, or 

b. The user types any of the following monitor commands: R, RUN, GET SAVE SSAVE 
CORE 0, and any CUSP-invoking command. 

When the fob is unlocked, it becomes a candidate for swapping and shuffling. CORMAX is increased 
to reflect the new size of the largest contiguous region available to unlocked fobs. However, CORMAX 
is never set to a greater value than its initial setting. 
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BEFORE 



AFTER 



J ! 

! ! 

I MONITOR ! 

; i 

! ! 

I time-sharing job ! 

! ISSUING LOCK UUO J 
! - « 

J///////////////////////! 

!///////////////////////: 

!///////////////////////! 

:///////////////////////• 

J///////////////////////! 
!/////////////////////// J 

i : 



LOCKED JOB 



/////////////////////// 
/////////////////////// 
//////////////, //////// 
/////////////////////// 
/////////////////////// 
/////////////////////// 



LOCKED JOB 



CORMAX 



MONITOR 



/////////////////////// 
/////////////////////// 
/////////////////////// 
/////////////////////// 
/////////////////////// 
/////////////////////// 
/////////////////////// 

ftftttittt/tttttttttftf 
/////////////////////// 
/////////////////////// 



IOCKED JOB 



LOCKED JOB 



/////////////////////// 
/////////////////////// 



LOCKED JOB 



♦ 
t 
t 

t 

CORMAX 
t 
t 
t 

t 
t 

•> 



Figure 8-1 Locking Jobs In Core (Cont) 



8-7 



8.3 RTTRP AC, OR CALLI AC, 57 

The real-time trapping UUO is used by timesharing users to dynamically connect real-time devices 
to the priority interrupt system, to respond to these devices at interrupt level, to remove the devices 
from the interrupt system, and to change the PI level to which the devices are associated. The 
RTTRP UUO can be called from UUO level or from interrupt level. This is a privileged UUO that 
requires the job to have real-time privileges (granted by LOGIN) and to be locked in core (accom- 
plished by LOCK UUO). These real-time privileges are assigned by the system manager and obtained 
by the monitor from ACCT.SYS. The privilege bits required are: 

1) PVLOCK - allows the job to be locked in core. 

2) PVRTT - allows the RTTRP UUO to be executed. 

WARNING 

Improper use of features of the RTTRP UUO can cause the 
system to hang. Since design goals of this UUO were to 
give the user as much flexibility as possible, some system 
integrity had to be sacrificed. The most common errors 
are protected against since user programs run in user mode 
with all ACs saved. 

Rear-time jobs control devices in one of two ways: block mode or single mode. In block mode, an 
entire block of data is read before the user's interrupt program is run. In single mode, the user's 
interrupt program is run every time the device interrupts. Furthermore, there are two types of block 
mode: fast block mode and normal block mode. These differ in response times. The response time 
to read a block of data in fast block mode is 6.5 u.s per word and in normal block mode, 14.6 us per 
word. (This is the CPU time to complete each data transfer.) In all modes, the response time measured 
from the receipt of the real-time device interrupt to the start of the user control program is 100 [as. 

The RTTRP UUO allows a real-time job to either put a BLKI or BLKO instruction directly on a PI level 
(block mode) or add a device to the front of the monitor PI channel CONSO skip chain (single mode). 
When an interrupt occurs from the real-time device in single mode or at the end of a block of data in 
block mode, the monitor saves the current state of the machine (the ACs, APR flags, protection- 
relocation register, UUO trap addresses 40 and 41 , and the reserved instruction trap addressed 60 and 
61), sets the new protection-relocation register and APR flags, and traps to the user's interrupt routine. 
The user services his device and then returns control to the monitor to restore the previous state of the 
machine and to dismiss the interrupt. 

In fast block mode the monitor places the BLKl/BLKO instruction directly in the PI trap location fol- 
lowed by a JSR to the context switcher. This action requires that the PI channel be dedicated to the 
real-time job during any transfers. In normal block mode the monitor places the BLKl/BLKO instruction 
directly after the real-time device's CONSO instruction in the CONSO skip chain as follows: 
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CONSO 


DEV, BITS 


JRST 


NXT DEV 


BLKI 


DEV, POINTR 


JRST 


< CONTEXT SWITCHER> 


JEN 


@CH, PI 



Any number of real-time devices using either single mode or normal block mode can be placed on any 
available PI channel. The average extra overhead for each real-time device on the same channel is 
5.5 u.s per interrupt. 



The call is: 

MOVEIAC, RTBLK 
RTTRP AC, 

error return 
normal return 

The data block depends on the mode used. 

RTBLK: XWD PICHL, TRPADR 

EXP APRTRP 

CONSO DEV, BITS 


The data block in fast block mode is: 

RTBLK: XWD PICHL, TRPADR 

EXP APRTRP 

BLKO DEV, BLKADR 





;AC contains address of data block. 

;or CALLI AC, 57; put device 

;on PI level . 

;AC contains an error code. 

;PI is set up properly. 

In single mode the data block is: 

;PI channel (1-6) and trap 

;address. 

;APR enable bits and APR 

;trap address. 

;CONSO chain instruction. 

;no BLKI/BLKO instruction. 



PI and trap address when 

BLKO done. 

APR trap conditions 

BLKI or BLKO instruction 

BLKADR points to the IOWD of 

block to be sent. 



The data block in normal block mode is: 

RTBLK: XWD PICHL, TRPADR 

EXP APRTRP 
CONSO DEV, @BITMSK 

BLKI DEV, BLKADR 



,-channel and trap address. 
;APR trap address. 
;control bit mask from 
;user area, 
;BLKI instruction. 



8.3.1 Data Block Mnemonics 

The following mnemonics are used in describing the data block associated with the RTTRP UUO. 
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8.3. 1. 1 PICHL - PICHL is the PI level on which the device is to be placed. Levels 1-6 are legal 
depending on the system configuration. If PICHL = 0, the device is removed from all levels. When 
a device is placed on a PI level, normally all other occurrences of the device on any PI level are 
removed. If the user desires the same device on more than one PI level simultaneously (i.e. , a data 
level and an error level), he can issue the RTTRP UUO with PICHL negative. This indicates to the 
system that any other occurrence of this device (on any PI level) is not to be removed. Note that this 
addition to a PI level counts as a real-time device occupying one of the possible real-time device 
slots. 

8.3. 1.2 TRPADR - TRPADR is the location trapped to by the real-time interrupt (JRST TRPADR). 
Before the trap occurs, all ACs are saved by the monitor and can be overwritten without concern for 
their contents. 

8.3.1.3 APRTRP - APRTRP is the trap location for all APR traps. When an APR trap occurs, the 
monitor simulates a JSR APRTRP. The user gains control from an APR trap on the same PI level that 
his real-time device is on. The monitor always traps to the user program on illegal memory references, 
non-existent memory references, and push-down overflows. This allows the user to properly turn off 
his real-time device if needed. The monitor also traps on the conditions specified by the APRENB UUO 
(see Paragraph 4.3.3. 1). No APR errors are detected if the interrupt routine is on a PI level higher 
than or equal to the APR interrupt level. 

8.3.1.4 DEV - DEV is the real-time device code. 

8.3.1.5 BITS - BITS is the bit mask of all interrupt bits of the real-time device and must not contain 
any other bits. If the user desires control of this bit mask from his user area, he may specify one level 
of indirection in the CONSO instruction (no indexing), i.e., CONSO DEV, @ MASK where MASK 
is the location in the user area of the bit mask. MASK must not have any bits set in the indirect or 
index fields. 

8.3.1.6 BLKADR - BLKADR is the address in the user's area of the BLKI/BLKO pointer word. Before 
returning to the user, the monitor adds the proper relocation factor to the right half of the pointer word. 
Data can only be read into the low segment above the protected job data area, i.e. , above location 

1 14. Since the pointer word is in the user's area, the user can set up a new pointer word when the 
word count goes to at interrupt level . This allows fast switching between buffers. When the user 
desires to set up his own pointer word, the right half of the word must be set up as an absolute address 
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instead of a relative address. The job's relocation value is returned from both the LOCK UUO and the 
first RTTRP UUO executed for setting the BLKl/BLKO instruction. If this pointer word does not contain 
a legal address, a portion of the system might be overwritten. A check should be made to determine if 
the negative word count in the left half of the pointer word is too large. If the word count extends 
beyond the user's own area, the device may cause a non-existent memory interrupt, or may overwrite 
a timesharing job. If all of the above precautions are taken, this method of setting up the pointer 
word is much faster and more flexible than issuing the RTTRP UUO at interrupt level. 

8.3.2 Interrupt Level Use of RTTRP 

The format of the RTTRP UUO at interrupt level is similar to the format at user level except for two 
restrictions: 

1) AC 16and AC 17 cannot be used in the UUO call (i.e., CALLI 16,57 is 
illegal at interrupt level). 

2) All ACs are overwritten when the UUO is executed at interrupt level. There- 
fore, the user must save any desired ACs before issuing the RTTRP UUO. This 
restriction is used to save time at interrupt level. 

CAUTION 

If an interrupt level routine executes a RTTRP UUO which 
affects the device currently being serviced, no additional 
UUOs of any kind (including RTTRP) can be executed dur- 
ing the remainder of the interrupt. At this point, any sub- 
sequent UUO dismisses the interrupt. 

8.3.3 RTTRP Returns 

On a normal return, the (ob is given user IOT privileges. These privileges allow the user to execute 
all restricted instructions including the necessary I/O instructions to control his device. 

The IOT privilege must be used with caution since improper use of the I/O instructions could halt the 
system (i.e., CONO APR,0, CONO PI,0, or HALT). Note that a user can obtain just the user IOT 
privilege by issuing the RTTRP UUO with PICHL = (see Paragraph 8.3. 1. 1). 

An error return is not given to the user until RTTRP scans the entire data block to find as many errors 
as possible. On return, AC may contain the following error codes. 

Code Value Meaning 

Bit 26=1 1000 Device already in use by another job. 

Bit 27=1 400 Illegal AC used during RTTRP UUO at interrupt level. 
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Code 


Value 


Bit 28=1 


200 


Bit 29=1 


100 


Bit 30=1 


40 


Bit 31=1 


20 


Bit 32=1 


10 


Bit 33=1 


4 


Bit 34=1 


2 


Bit 35=1 


1 



Meaning 
Job not locked in core, or not privileged. 
System limit for real-time devices exceeded. 
Illegal format of CONSO, BLKO, or BLKI instruction. 
BLKADR or pointer word illegal. 
Error address out of bounds. 
Trap address out of bounds. 

PI channel not currently available for BLKl/BLKO's. 
PI channel not available (restricted use by system). 



8.3.4 Restrictions 



1) Devices may be chained onto any PI channel that is not used for BLKl/BLKO instructions 
by the system or by other real time users using fast block mode. This includes the APR 
channel. Normally PI levels 1 and 2 are reserved by the system for magnetic tapes and 
DECtapes. PI level 7 is always reserved for the system. 

2) Each device must be chained onto a PI level before the user program issues the CONO 
DEV, PIA to set the device onto the interrupt level. Failure to observe this rule or 
failure to set the device on the same PI level that was specified in the RTTRP UUO could 
hang the system. 

3) If the CONSO bit mask is set up and one of the corresponding flags in a device is on, 
but the device has not been physically put on its proper PI level, a trap may occur to 
the user's interrupt service routine. This occurs because there is a CONSO skip chain 
for each PI level, and if another device interrupts whose CONSO instruction is further 
down the chain than that of the real-time device, the CONSO associated with the real- 
time device is executed. If one of the hardware device flags is set and the corresponding 
bit in the CONSO bit mask is set, the CONSO skips and a trap occurs to the user program 
even though the real-time device was not causing the interrupt on that channel. To avoid 
this situation the user can keep the CONSO bit mask in his user area (see Paragraph 

8.3. 1 .5.). This procedure allows the user to chain a device onto the interrupt level , 
keeping the CONSO bit mask zero until the device is actually put on the proper PI level 
with a CONO instruction. This situation never arises if the device flags are turned off 
until the CONO DEV, PIA can be executed. 

4) The user should guard against putting programs on high priority interrupt levels which 
execute for long periods of time. These programs could cause real-time programs at 
lower levels to lose data. 

5) The user program must not change any locations in the protected job data area (locations 
20-114) since the user is running at interrupt level and full context switching is not 
performed. 

6) If the user is using the BLKl/BLKO feature, he must restore the BLKl/BLKO pointer word 
before dismissing any end-of-block interrupts. This is accomplished with another RTTRP 
UUO or by directly modifying the absolute pointer word supplied by the first RTTRP UUO. 
Failure to reset the pointer word could cause the device to overwrite all of memory. 
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8.3.5 Removing Devices from a PI Channel 

When PICHL=0 in the data block (see Paragraph 8.3.1.1), the device specified in the CONSO 
instruction is removed from the interrupt system. If the user removes a device from a PI chain, he 
must also remove the device from the PI level (CONO DEV,0). 

A RESET, EXIT, or RUN UUO from the timesharing levels removes all devices from the interrupt levels 
(see Paragraph 8.2). This UUO causes a CONO DEV,0 to be executed before the device is removed. 
Monitor commands which issue implicit RESETS also remove real-time devices (e.g., R, RUN, GET, 
COREO, SAVE, SSAVE). 

8.3.6 Dismissing the Interrupt 

The user program must always dismiss the interrupt in order to allow monitor to properly restore the state 
of the machine. The interrupt may be dismissed with any UUO other than the RTTRP UUO or any in- 
struction which traps to absolute location 60. The standard method of dismissing the interrupt is with 
a UJEN instruction (op code 100). This instruction gives the fastest possible dismissal by trapping to 
location 60. 

8.3.7 Examples 

********** EXAMPLE 1 ********** 
SINGLE MODE 

TITLE RTSNGL - PAPER TAPE READ TEST USING CONSO CHAIN 



PDATA: 
PTRTST! 



PIOFF=400 
PION=200 
TAPE=400 
BUSY=20 

DONE=10 



RESET 

LOCK 

JRST 

SETZM 

SETZM 

MOVE I 

RTTRP 

JRST 

MOVE I 

HLRZ 

TRO 2 

CONO 

WOVEN! 

CONO 

CONO 



FAILED 
PTRCSO 

DONFLG 
RTBLK 

FAILED 
1 ,DONE 

2* RTBLK 

jBUSY 

PI,PI0FF 
1 , PTRCSO 

PTR,<2> 

PI>PION 



J TURN PI SYSTEM OFF 

{TURN PI SYSTEM ON 

J NO MOKE TAPE IN READER IF TAPE=0 

{DEVICE IS BUSY HEADING 

{A CHARACTER HAS BEEN READ 

{LOCATION WHERE DATA IS READ INTO 

{RESET THE PROGRAM 

{LOCK THE JOB IN CORE 

{LOCK UUO FAILED 

{MAKE SURE CONSO BITS ARE ZERO 

{INITIALIZE DONE FLAG 

{GET ADDRESS OF REAL TIME DATA BLOCK 

{PUT REAL TIME DEVICE ON THE PI LEVEL 

{RTTRP UUO FAILED 

{SET UP CONSO BIT MASK 

{GET PI NUMBER FROM RTBLK 

{SET UP CONO BITS TO START TAPE GOING 

{GUARD AGAINST ANY INTEKRUPTS 

{STORE CONSO BIT MASK 

{TURN PTR ON 

{ALLOW INTERRUPTS AGAIN 
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MOVE I 


5 




CALLI 


31 




SKIPN 


DONFLG 




JRST 


.-3 




EXIT 




RTBLK: 


XWD 5 


, TRPADR 




EXP APRTRP 




CONSO 


PTR^SPTRCSO 




Z 




PTRCSO: 


Z 




DONFLG: 


z 




RTBLK 1 : 


z 
1 






CONSO 


PTR..0 




z 




TRPADR: 


CONSO 


PTR>TAPE 




HRST TDONE 




DATA I 


PTR»PDATA 




UJEN 




APRTRP: 


z 




TDONE: 


MOVEI 


RTBLK1 




CONO PTR*0 




RTTRP 






JFCL 






SETOM 


DONFLG 




SETZM 


PTRCSO 




UJEN 





;SET UP TO SLEEP FOK 5 SECONDS 

JSLEEP 

JHAVE 'WE FINISHED READING THE TAPE 

;NO GO BACK TO SLEEP 



;PI CHANNEL AND TRAP ADDRESS 
JAPR ERROR TkAP ADDRESS 
; INDIRECT CONSO BIT MASK = PTRCSO 
iNO BLKI/O INSTRUCTION 

iCONSO BIT MASK 

;PI LEVEL TO USER LEVEL C OMM • 
JDATA BLOCK TO REMOVE PTR 
J FROM PI CHANNEL 



JEND OF TAPE? 
J YES, GO STOP JOB 
JREAD IN DATA WORD 
^DISMISS THE INTERRUPT 

JAPR ERROR TRAP ADDRESS 

;SET UP TO REMOVE PTR 

JTAKE DEVICE OFF HARDWARE PI LEVEL 

^REMOVE FROM SOFTWARE PI LEVEL 

J IGNORE ERRORS 

J MARK THAT READ IS OVER 

iCLEAR CONSO BIT MASK 

^DISMISS THE INTERRUPT 



FAILED: TTCALL 3 j CASC I Z/RTTRP UUO FAILED!/] 
EXIT 

END PTRTST 



********** EXAMPLE 2 ********** 
FAST BLOCK MODE 

TITLE RTFBLK - PAPER TAPE READ TEST IN BLKI MODE 



TAPE=400 

BUSY=20 

DONE=10 



;NO MORE TAPE IN READER IF TAPE=0 
JDEVICE IS BUSY READING 
JA CHARACTER HAS BEEN READ 



BLKTST; 



RESET 

LOCK 

JRST 

SETZM 

MOVEI 

RTTRP 

JRST 

HLRZ 

TRO 2 

CONO 

MOVEI 

CALLI 

SKIPN 

JRST 

EXIT 



FAILED 
DONFLG 
RTBLK 

FAILED 
2, RTBLK 
*BUSY 
PTR,C2) 

5 

31 

DONFLG 

-3 



(RESET THE PROGRAM 

SLOCK THE JOB IN CORE 

SLOCK UUO FAILED 

S INITIALIZE DONE FLAG 

SGET ADDRESS OF REAL TIME DATA BLOCK 

SPUT REAL TIME DEVICE ON THE PI LEVEL 

SRTTRP UUO FAILED 

SGET PI NUMBER FROM RTBLK 

iSET UP CONO BITS TO START TAPE GOING 

iTURN PTR ON 

SSET UP TO SLEEP FOR 5 SECONDS 

SSLEEP 

SHAVE WE FINISHED READING THE TAPE 

SNO GO BACK TO SLEEP 
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RTBLK: XWD 6,TRPADR 
EXP APRTRP 
BLKI PTR, POINTR 
Z 



iPl CHANNEL AND TRAP ADDRESS 

;apr error trap address 
jread a block at a time 



POINTR: 
OPOINT: 
TABLE: 
DONFLP: 
RTBLK 1 : 



IOWD 5, TABLE 

IOWD 5, TABLE 

BLOCK 5 

Z 

Z 

Z 

CONSO PTR,0 

Z 



^POINTER FOR BLKI INSTRUCTION 
^ORIGINAL POINTER WORD FOR BLKI 
STABLE AREA FOR DATA BEING READ 
;PI LEVEL TO USER LEVEL COMM. 
JDATA BLOCK TO REMOVE PTR 
JFROM PI CHANNEL 



TRPADR: CONSO PTR , TAPE 
JRST TDONE 
MOVE OPOINT 
MOVEM POINTR 
UJEN 



i END OF TAPE? 

;YES, GO STOP JOB 

iGET ORIGINAL POINTER WORD 

^RESTORE BLKI POINTER WORD 

iDISMISS THE INTERRUPT 



APRTRP : 

TDONE: 



MOVEI RTBLK1 

CONO PTR,0 

RTTRP 

JFCL 

SETOM DONFLG 

UJEN 



>APk ERROR TRAP ADDRESS 

;SET UP TO REMOVE PTR 

;TAKE DEVICE OFF HARDWARE PI LEVEL 

^REMOVE FROM SOFTWARE PI LEVEL 

i IGNORE ERRORS 

;MARK THAT READ IS OVER 

^DISMISS THE INTERRUPT 



FAILED: TTCALL. 3* CASC IZ/RTTRP ULIO FAILED! /J 
EXIT 

END BLKTST 



********** EXAMPLE 3 ********** 
NORMAL BLOCK MODE 

TITLE RTNBLK - PAPER TAPE READ TEST IN BLKI MODE 



TAPE=400 

BUSY=20 

DONE=10 



BLKTST: 



RESET 

LOCK 

JRST 

MOVEI 

RTTRP 

JRST 

CONO 

SETZM 

MOVEI 

RTTRP 

JRST 

MOVE 

MOVEM 

HLRZ 

TRO 2 

CONO 

MOVEI 

SLEEP 

SKIPN 

JRST 

EXIT 



FAILED 
RTBLK1 

FAILED 

PTR,0 
DONFLG 
RTBLK 

FAILED 
POINTR 

OPOINT 
2, RTBLK 
..BUSY 
PTR*<2> 

5 

DONFLG 
.-3 



i NO MORE TAPE IN READER IF TAPE=0 
JDEVICE IS BUSY READING 
JA CHARACTER HAS BEEN READ 

»IO RESET 

JLOCK THE JOB IN CORE 

J LOCK UUO FAILED 

JGET ADDRESS OF REAL TIME BLOCK 

iGET USER IOT PRIVILEGE 

;UUO FAILED! 

JCLEAR ALL PTR FLAGS 

i INITIALIZE DONE FLAG 

JGET ADDRESS OF REAL TIME DATA BLOCK 

;PUT REAL TIME DEVICE ON THE PI LEVEL 

;RTTRP UUO FAILED 

J GET RELOCATED POINTER WORD FOR LATER 

;STORF. FOR INTERRUPT LEVEL USE 

iGET PI NUMBER FROM RTBLK 

iSET UP CONO BITS TO START TAPE GOING 

;TURN PTR ON 

;SET UP TO SLEEP FOR 5 SECONDS 

JHAVE WE FINISHED READING THE TAPE 
JNO GO BACK TO SLEEP 
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RTBLK: 


XWD 6* TRPADR 




EXP APRTRP 




CONSO PTRjDONE 




BLKI PTR^POINTR 


POINTR: 


IOWD 5, TABLE 


OPOINT: 


Z 


TABLE: 


BLOCK 5 


DONFLG: 


Z 


RTBLK 1 : 


z 




z 




CONSO PTR,0 




z 


TRPADR : 


CONSO PTR, TAPE 




JRST TDONE 




MOVE OPOINT 




MOVEM POINTR 




UJEN 


APRTRP: 


z 


TDONE : 


MOVE I RTBLK 1 




CONO PTR,0 




RTTRP 




JECL 




SETOM DONFLG 




UJEN 


FAILED: 


TTCALL 3, EASCIZ 




EXIT 




END BKJTST 



iPl CHANNEL AND TRAP ADDRESS 
;APR ERROR TRAP ADDRESS 
;WAIT ONLY FOR DONE FLAG 
; READ A BLOCK AT A TIME 

^POINTER FOR BLKI INSTRUCTION 

;TABLE AREA FOR DATA BEING READ 
JPI LEVEL TO USER LEVEL COMM. 
JDATA BLOCK TO REMOVE PTR 
JFROM PI CHANNEL 



JEND OF TAPE? 

;YES, GO STOP JOB 

;GET ORIGINAL POINTER WORD 

iSTORE IN POINTER LOCATION 

^DISMISS THE INTERRUPT 

JAPR ERROR TRAP ADDRESS 

;SET UP TO REMOVE PTR 

;TAKE DEVICE OFF HARDWARE PI LEVEL 

^REMOVE FROM SOFTWARE PI LEVEL 

} IGNORE ERRORS 

JMARK THAT READ IS OVER 

JDISMISS THE INTERRUPT 
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8.3.8 FORTRAN Usage of Real-Time Trapping 

Real-time library subroutines allow FORTRAN programs to connect real-time devices to the priority 
interrupt system. These subroutines provide the FORTRAN-oriented user the flexibility needed to 
write real-time code without the requirement of learning assembly language coding and hardware 
peculiarities. At present these subroutines are not reentrant and cannot be called from two PI levels 
simultaneously. If this is a requirement, then a different routine must be called at each level. 

To enter the same subroutine from two or more PI levels simultaneously, the following MACRO pro- 
gram can be used: 





TITLE 


SUB1 




ENTRY 


SUB1, SUB2 




EXTERN 


SUB 


SUB1: 


Z 






JRST 


SUB+1 


SUB2: 


Z 






JRST 


SUB+1 




END 





For each PI level which needs the subroutine SUB, a new ENTRY point must be made. In the example 
above, three different PI levels could be active simultaneously using the three different CALLS to the 
same routine (CALL SUB, CALL SUB1, and CALL SUB2). This technique can be used for any routine 
which is reentrant except for the FORTRAN CALL sequence. All of the real-time subroutines except 
for CONECT and DISCON meet this requirement. 

The real-time subroutines and their functions are as follows. 



8.3.8. 1 LOCK - The LOCK subroutine locks the job in core. This routine must be called before any 
other routines can be executed. The call is 

CALL LOCK 



8.3.8.2 RTINIT - The RTINIT subroutine initializes all the internal tables controlling the real-time 
device specified. The call is 

CALL RTINIT (unit, dev, PI, TRPADR, MASK) 



where 



unit is the real time device unit number (starting at 1). 

dev is the device code for the real-time device. 

PI is the PI level on which the device is to be placed. 
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TRPADR is the address in the FORTRAN program where real time interrupts are to trap. 
This address is loaded by ASSIGN 100 to TRPADR. 

MASK is the mask of all interrupting flags for the real time device. This mask is set 
by RTSTRT (see Paragraph 8.3.8.5) and should be zero when the real-time 
device is inactive. 



8.3.8.3 CONECT - The CONECT subroutine indicates to the system that the real-time device speci- 
fied is to be connected to the indicated PI level and the trap address for trapping is to be set up. The 
call is 



where 



CALL CONECT (unit, mode) 



unit is the real-time device unit number. 

Mode is -1 for writing blocks of data. 

for a trap on each device interrupt. 
+ 1 for reading blocks of data . 



8.3.8.4 DISCON - The DISCON subroutine disconnects the real-time device from the PI level 
The call is 

CALL DISCON (unit) 



where 



unit is the real-time device unit number. 



8.3.8.5 RTSTRT - The RTSTRT subroutine starts the real-time device with a CONO DEV, START and 
can also be used to stop the device and zero the CONSO mask (i .e. , CALL RTSTRT (unit, 0,0)). This 
is the preferred method for stopping the device. The call is 



where 



CALL RTSTRT (unit, start, intmsk) 



unit is the real-time device unit number. 

start is the flags necessary to start the device (CONO DEV, START), 
intmsk is the mask of all interrupting bits. These bits are loaded into MASK 
(refer to Paragraph 8.3.8.2). 
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8.3.8.6 BLKRW - The BLKRW subroutine sets up the size and the starting address of the block of 
data. The call is 

CALL BLKRW (unit, count, adr) 

where 

unit is the real-time device unit number. 

count is the number of words to be read or written. 

adr is the array from which the data is transferred depending on the MODE setting. 

After the specified number of words are read or written, a trap occurs to the interrupt trap routine. 
A new count and starting address must be set up each time the present one is exhausted. 

8.3.8.7 RTREAD - The RTREAD subroutine reads a single word of data from the real-time device 
(DATAI DEV, ADR). The call is 

CALL RTREAD (unit, adr) 

where 

unit is the real-time device unit number, 
adr is the address of the data to be read. 

8.3.8.8 RTWRIT - The RTWRIT subroutine sends a single word of data to the real-time device (DATAO 
DEV, ADR). The call is 

CALL RTWRIT (unit, adr) 

where 

unit is the real-time device unit number. 

adr is the address of the data word to be sent to the real-time device. 

8.3.8.9 STATO - The STATO subroutine sends an argument to the status register of the device. The 
call is 

CALL STATO (unit, adr) 

where 

unit is the real-time device unit number. 

adr is the location of the status bits to be sent to the real-time device 

(CO NO DEV, @ ADR). 
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8.3.8. 10 STATI - The STATI subroutine reads the current status bits into a specified location. The 
call is 

CALL STATI (unit, adr) 



where 



unit is the real-time device unit number. 

adr is the location in which the device status bits are to be read (CONO DEV, ADR). 



8.3.8.11 RTSLP - The RTSLP subroutine causes the background portion of the FORTRAN program to 
sleep for a specified number of seconds (maximum of 60). The call is 

CALL RTSLP (time) 

where 

time is the sleep interval in seconds. 

RTSLP is called from the timesharing level causing the program to sleep for the specified amount of 
time. When the sleep interval reaches zero, the program checks to see if RTWAKE has been called 
at interrupt level. If RTWAKE has been called, RESLP returns to the calling program. If RTWAKE has 
not been called, the background portion of the job goes back to sleep again. 

8.3.8. 12 RTWAKE - The RTWAKE subroutine activates the background portion of the FORTRAN 
program. This subroutine is called at interrupt level. The call is 

CALL RTWAKE 

8.3.8.13 Example - The following is an example of a FORTRAN real-time program. 

IMPLICIT INTEGER CA-Z) 
DIMENSION A (100) 

C LOCK THE JOB IN CORE 
CALL LOCK 

C 20 IS THE BEGINNING OE THE REAL-TIME SECTION 
C THE PI LEVEL OF THE REAL-TIME JOB IS 5 
C THE DEVICE CODE IS OCTAL 104 

ASSIGN 20 TO TRPADR 

UNIT = 1 

PI = 5 

DEV = "104 

MASK = 

C INITIALIZE REAL TIME DEVICE 

CALL RTINIT (UNIT* DEV* PI* TRPADR* MASK) 
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MODE = 

C CONNECT DEVICE TO PI LEVEL 
CALL CONECT (UNIT* MODE) 

CONO = "25 
CONSO = "10 

C START REAL TIME DEVICE 

CALL RTSTRT (UNIT* CONO* CONSO) 

C SLEEP FOR FIVE SECONDS* THEN CHECK FOR A RTWAKE CALL 
C AT INTERRUPT LEVEL 
10 CALL RTSLP (5) 

CALL EXIT 

C INTERRUPT LEVEL SECTION 

C HAS THE READER RUN OUT OF PAPER TAPE? 

20 CALL STATI (UNIT* J) 

IF (J-"400.GE.0) GO TO 21 

C YES* THERE IS NO MORE TAPE* SO WAKE UP 
C BACKGROUND PORTION OF JOB 

CALL RTSTRT <UNIT*0*0) 
CALL DISCON CUNIT) 
CALL RTWAKE 
CALL DISMISS 

C THERE IS STILL PAPER TAPE IN THE 
C READER. READ ANOTHER CHARACTER. 

21 CALL RTREAD <UNIT*X) 
CALL DISMIS 

END 



8.4 DIRECT USER I/O 

In special cases, the RTTRP UUO does not offer a fast enough response to real-time interrupts. These 
special cases can always be solved by putting a device service routine into the monitor. However, 
some of the fast response requirements can be met with the TRPSET feature. In order to achieve fast 
response to interrupts, the TRPSET feature turns off timesharing during its use. This limits the class 
of problems to be solved to cases where the user wants to transfer data in short bursts at predefined 
times. Therefore, since the data transfers are short, the time during which timesharing is stopped is 
also short, and the pause probably will not be noticed by the timesharing users. 

8.4.1 TRPSET AC, or CALLI AC,25 

This privileged UUO allows the user program to gain control of the interrupt locations. If the user does 
| not have the TRPSET privileges (either PVTRPS ~ 1 (bit 15), or user is job 1), an error return to the next 
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location after the CALL is always given, and the user remains in user mode. Timesharing is turned back 
on. If the user has the TRPSET privileges, the central processor is placed in user l/O mode. If AC 
contains zero, timesharing is turned on if it was turned off. If the LH of AC is within the range 40 
through 57, all other jobs are stopped from being scheduled and the specified executive PI location 
(40-57) is patched to trap directly to the user. In this case, the monitor moves the contents of the 
relative location specified in the right half of AC, adds the job relocation address to the address field, 
and stores it in the specified executive PI location. 

Thus, the user can set up a priority interrupt trap into his relocated core area. Upon a normal return, 
AC contains the previous contents of the address specified by LH of AC, so that the user program may 
restore the original contents of the PI location when the user is through using this UUO. If the LH of 
AC is not within the range 40 through 57, an error return is given just as if the user did not have the 
privileges. The call is: 

MOVE AC»CXWD N* ADR 1 
TRPSET AC* 
ERROR RETURN 
NORMAL RETURN 



ADR: 



TRAP: 



JSR TRAP 



Instruction to be stored 
;in exec PI location 
;after relocation added to it. 
j Here on interrupt from exec. 



The monitor assumes that user location ADR contains either a JSR U or BLKI U, where U is a user ad- 
dress; consequently, the monitor adds the job relocation to the contents of location U to make it an 
absolute IOWD. Therefore, a user should reset the contents of U before every TRPSET call . 

A RESET UUO returns the user to normal user mode. The following instruction sequence is used to 
place the real-time device RTD on channel 3. 



INT 46: 
INT 47: 



BLKI RTD»INBL0K 
JSR X IT INT 



START : 



MOVEI AC.INT46 
HRLI AC* 46 
TRPSET AC* 
JRST EXITR 
AOBJN AC* «+l 
XCT .-3 
JRST EXITR 



XITINT: 



^relocation constant 
}for user is added 
jto RH when instructions 
*are placed into 46 and 47. 



;error return 
j norma I return 

;error return 
; norma I return 

iPC saved 

j interrupt dismiss routine 
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If the interrupt occurs while some other part of the user's program is running, the user may dismiss from 
the interrupt routine with a JEN @ XITINT. However, if the machine is in executive mode, a JEN 
instruction issued in user mode does not work because of memory relocation. This is solved by a call 
to UJEN (opcode 100). This UUO causes the monitor to dismiss the interrupt from executive mode. 
In this case, the address field of the UJEN instruction is the user location when the return PC is stored 
(i.e., UJEN XITINT). The following sequence enables the user program to decide whether it can issue 
a JEN to save time or dismiss the interrupt with a UUO call. 



XITINT: 

JRST 1*.+1 



MOVEM AC» SAVEAC 



,PC with bits in LH 

;essential instruction, 
^returns machine to 
;user mode, 
jsave accumulator AC 
;service interrupt here 



MOVE AC* XITINT 
SETZM EFLAG 

TLNN AC* 10000 

SETOM EFLAG 
MOVE AC» SAVEAC 
SKIPE EFLAG 
UJEN XITINT 
JEN 8 XITINT 





jget PC with bits 



jwas machine in user 

;mode at entry? 

jno 

i RESTORE saved AC 

{not in user mode at entry 



SAVEAC : 
EFLAG s 

Upon entering the routine from absolute 47 with a JSR to XITINT + REL (where REL. is the relocation 
constant), the executive mode flip-flop is set. The first executed instruction in the user's routine 
must, therefore, reset the user mode flag, thereby enabling relocation and protection. The user must 
proceed with caution when changing channel interrupt chains under timesharing, making certain that 
the real-time job can coexist with other timesharing jobs. 

8.4.2 UJEN (Op Code 100) 

This op code dismisses a user ]/0 mode interrupt if one is in progress. If the interrupt is from user 
mode, a JRST 12, instruction dismisses the interrupt. If the interrupt came from executive mode, 
however, this operator is used to dismiss the interrupt. The monitor restores all accumulators, and 
executes JEN @ U where user location U contains the program counter as stored by a JSR instruction 
when the interrupt occurred. 



8-23 



8.5 HPQ AC, OR CALLI AC,71 

The HPQ UUO is used by privileged users to place their jobs in a high-priority scheduler run queue. 
These queues are always scanned by the scheduler before the normal run queues, and any runnable 
job in one of these queues is executed before all other Jobs in the system. Thus, real-time associated 
jobs can receive fast response times from the timesharing scheduler. 

In addition to being scanned according to their priority before all other queues for job execution and 
swap-in, the high priority queues are scanned in reverse order (lowest priority first, highest priority 
last) for swap-out after all other queues have been scanned. If the highest priority job has been 
swapped onto the disk, then that job is the first job to be swapped in for execution. 

8.5.1 HPQ UUO Format 

The HPQ UUO requires as an argument the high-priority queue number of the queue to be entered. 
The lowest high-priority queue is 1 , and the highest priority queue is equivalent to the number of 
queues that the system is built for. The call is as follows: 

MOVE AC, HPQNUM ;get high-priority queue number 

HPQ AC, ;or CALLI AC, 71 

error return 
normal return 

On an error return, AC contains -1 if the user did not have the correct privileges. The privilege bits 
are bits 6 through 9 in the privilege word. These four bits specify a number from 0-17 octal , which 
is the highest priority queue attainable by the user. 

On a normal return, the job is in the desired high-priority queue. A RESET or an EXIT UUO places 
the job back to the timesharing level . 
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Appendix A 

DECtape Compatibility 
Between DEC Computers 







r PDP 


PDP 


PDP 


PDP 


PDP 


PDP 


PDP 


PDP 


PDP 




Read 
By S 


4 


5 


6 


7 


8 


8 


8/1 


9 


10 




550 and 


552 and 


551 and 


550 and 


552 and 


TC01 


TC01 


TC01 


TC01 




555 


555 


555 


555 


555 


and 


and 


and 


and 






TU55 


TU55 


TU55 


TU55 


TU55 


TU55 


TU55 


TU55 


TU55 




PDP-4 


A 


D 


D 


A 


D 


D 


D 


D 


D 




PDP-5 


D 


A 


B 


C 


A 


A 


A 


A 


A 




PDP-6 


D 


A 


A 


C 


A 


A 


A 


A 


A 




PDP-7 


A 


C 


C 


A 


C 


C 


C 


C 


C 


Written , 
By < 


PDP-8 


D 


A 


B 


C 


A 


A 


A 


A 


A 


552 






















PDP-8 


D 


A 


B 


C 


A 


A 


A 


A 


A 




TC01 






















PDP-8/I 


D 


A 


B 


C 


A 


A 


A 


A 


A 




PDP-9 


D 


A 


A 


C 


A 


A 


A 


A 


A 




PDP-10 


D 


A 


A 


C 


A 


A 


A 


A 


A 



A = Can be done 

B = Cannot be done because of difference in writing checksum 

C = Can be done with programmed checksum 

D =Can probably be done as in (C) except that PDP-4 is too slow for calculating 
the exclusive or checksum in line; calculations must be done before writing . 

NOTE 

The PDP-10 does not allow search to find first or last 
blocks when searching from the end-zone. 
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Appendix B 
Monitor Sizes 



B.l MULTIPROGRAMMING NON-DISK MONITOR (JUNE 1970, REENTRANT 4 SERIES, 
VERSION 72) 

Three resident components of the monitor are: 

a. Required code (6. 2K) 

b. Optional device code (0-4.4K) 

c. Tables and buffers per job (73 words per job) 



B.l .1 Required Code 

The required code, assuming all features, is: 



Lower core 


DLSINT 


Common 


ERRCON 


CLSCSS 


SCNSRF 


CLOCK! 


SEGCON 


COMCON 


SYSINT 


CORE1 


UUOCON 



B.l. 2 Optional Device Code 

The optional devices are listed below with the number of devices used in figuring the optional device 
code. 



Device 



Number 



Device 



Number 



DTA 


8 


DIS 1 


MTA 


2 


LPT 1 


PTY 


2 


PLT 1 


CDR 


1 


PTP 1 


CDP 


1 


PTR 1 
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B.l .3 Tables and Buffers 

Tables and buffers allowed for each job are: 

18 words of tables 

55 w ords of TTY device data block space 

73 words per Job 

B.2 SWAPPING MONITOR (JUNE 1970, REENTRANT 5 SERIES, VERSION 01) 
Three resident components of the monitor are: 

a. Required code (14K) 

b. Optional device code (5.2K) 

c. Tables and buffers per job (IK for every 4 jobs) 



B.2.1 Required Code 

The required code, assuming all features, is: 



Lower core 

COMMON 

CCINT 

CLOCK 1 

COMCON 

CORE1 

ERRCON 

FTLSER 



JOBDAT 

SCHED1 

SCNSRF 

SEGCON 

SWPSER 

SYSINI 

TMPUUO 

UUOCON 



B.2. 2 Optional Device Code 

The optional devices are listed below with the number of devices used in figuring the optional device 
code. 



Devi 



Numbe 



Device 



Number 



DTA 


8 


DIS 




MTA 


3 


LPT 




PTY 


2 


PLT 




CDR 


1 


PTP 




CDP 


1 


PTR 




FHA 


2 


DPA 


4 
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B.2.3 Tables and Buffers 

Tables and buffers allowed for each Job are: 

21 words of tables 

90 words of DSK device data blocks (approximately 3 files) 
40 words of DSK access information 
20 words of TMPCOR storage 
55 w ords of TTY device data block space 
226 words per job 

For a complete swapping system, the resident monitor is (assuming all devices): 

8 JOBS 21K 

16 JOBS 23K 

24 JOBS 25K 

32 JOBS 27K 

40 JOBS 29K 

48 JOBS 31K 

56 JOBS 33K 

64 JOBS 35K 
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Appendix C 

Writing Reentrant User Programs 



C . 1 DEFINING VARIABLES AND ARRAYS 

The LOADER simplification makes it somewhat more difficult to define variables and arrays. The 
easiest way to define variables and arrays, so the resulting relocatable binary can be loaded on a one- 
or two-segment machine, is to put them all in a separate sub-program as internal global symbols using 
Block 1 and Block N pseudo-ops. AM other subprograms refer to this data as external global locations. 
Most reentrant programs have at least two subprograms, one for the definition of low segment locations 
and one for instructions and constants for the high segment. (This last subprogram must have a HISEG 
pseudo-op.) Programs are self-initializing; therefore, they clear the low segment when they are started 
although the monitor clears core when it assigns it to a user. 

Block 1 and Block N pseudo-ops cause the LOADER to leave indications in the job data area (LH of 
JOBCOR) so a monitor SAVE command will not write the low segment. This is advantageous in shar- 
able programs for two reasons. It reduces the number of files in small DECtape directories (22 files in 
the maximum). Also, I/O is accomplished only on the first user's GET that initializes the high seg- 
ment, but not on any subsequent user's GETs for either the high or low segment. 

C.2 EXAMPLE OF TWO-SEGMENT REENTRANT PROGRAM 

LOW SEGMENT SUBPROGRAM: 

TITLE LOW - EXAMPLE OF LOW SEGMENT SUB-PROGRAM 

J0BVER=1 37 
LOC JOBVER 

3 JVERSI0N3 

RELOC 

INTERNAL LOWBEG^DATA , DATA 1 , DA TA2, TABLE, TABLE1 

LOWBEG: 

DATA: BLOCK 1 

DATA1 : BLOCK 1 

DATA?: BLOCK 1 

TABLE: B.LOCK 10 
TABLE1 : BLOCK 10 
L0WEND=.-1 ;LAST LOCATION TO BE CLEARED 



END 
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HIGH SEGMENT SUBPROGRAM: 

TITLE HIGH - EXAMPLE OF HIGH SEGMENT SUB-PROGRAM 

HISEG 

EXTERN LOWBEG'LOWEND 
T=l 

BEGIN: SETZM LOWBEG S CLEAR DATA AREA 

MOVEI T..LOWBEG+1 

HRLI T..LOWBEG 

BLT TjLOWEND 

MOVE T..DATA1 ^COMPUTE 

ADDI 1 > 1 
MOVEM T > DATA2 



END BEGIN ^STARTING ADDRESS 

C.3 CONSTANT DATA 

Some reentrant programs require certain locations in the low segment to contain constant data, which 
does not change during execution. The initialization of this data happens only once after each GET, 
instead of after each START; therefore, programmers are tempted to place these constants in the sub- 
program that contains the definition of the variable data locations. This action requires the SAVE 
command to write the constants out and the GET command to load the constants in again; therefore, 
the constant data should be moved by the programs from the high segment to the low segment when the 
rest of the low segment is being initialized. The exception is when the amount of code and constants 
in the high segment needed to initialize the low segment constants take up too much room in the high 
segment. In this case, it is best to have I/O in the low segment on each GET. A rule to follow in 
deciding between this high segment core space and the low segment GET I/O time is to put the code in 
the high segment if it does not put the high segment over the next IK boundary. 

C.4 SINGLE SOURCE FILE 

A second way of writing single save file reentrant programs is to have a single source file instead of 
two separate ones. This is more convenient, although it involves conditional assembly and, therefore, 
produces two different relocatable binaries. A number of CUSPs have been written this way. 

The idea is to have a conditional switch which is 1 if a reentrant assembly and if a non-reentrant 
assembly. The data is placed last in the source file following a LIT pseudo-op and consists only of 
Block 1 and Block N statements, along with data location tags. If a reentrant program is desired, a 
LOC 140 is assembled, which places the data at absolute 140 in the low segment. Because of the LOC, 
no other relocatable program can be loaded into the low segment. The program should be debugged 
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as a non-reentrant program with DDT because DDT is a low segment relocatable file. The LOADER 
switch /B is used to protect the symbols. The usual way of assembly is reentrant, therefore, unless 
already defined, the conditional switch is 1. 



The program must have one location in the [ob data area when it is assembled to be reentrant so that 
the monitor starts assigning buffers at the end of the data area in the low segment instead of at loca- 
tion 140. This is accomplished by changing the LH of JOBSA before the CALLI (RESET) or changing 
the contents of JOBFF after the CALLI 0, depending on how the program reinitializes itself on errors 
and on completion. The program should not change these locations If it is assembled as non-reentrant; 
thus, the symbol table can be protected using the LOADER /B switch, which places the symbols next 
to the last program loaded and sets the LH of JOBSA appropriately higher. Therefore, this code is 
under control of conditional assembly. 

TITLE DEMO - DEMO ONE SOURCE REENTRANT PROGRAM -V00 1 

J0RVER=1 37 
LOG 1 37 
EXP 001 



INTERN JORVER'PURE 
EXTERN JOBSA , JOBFF 

IFN10FF PURE*<PURE=1 > 
IFN PURE..<HISEG> 



AVERSION NUMBER 



iASSUME REENTRANT IF PURE UNDEFINED 
iTELL LOADER TO LOAD IN HIGH SEGMENT 
;IF REENTRANT 



PEG: 






IFN 


PURE.- < 






MOVSI 


TjDATAE 




HLLM 


T > JOBSA 




CALLI 







MOVE 


T. JOBFF 




CALLI 


T.l 1 




JRST 


ERROR 




MOVE 


Tj [XUiD 




SETZM 


DATAB 




BLT 


TjDATAE 



50NLY NEED IF REENTRANT 

JCNOT NEEDED IF TWO FILES) 

JSET FIRST FREE LOCATION IN LOW SEG* 

PRESET SETS JOBFF FROM LH OF JOBSA 

JDO CALL RESET 

^ASSIGN AT LEAST ENOUGh CORE FOR DATA 

JCORE UUO 

:AB+1 ] iNOW CLEAR DATA REGION 

J-AST LOCATION CLEARED 



LIT 

IFN PURE., <L0C 1 40> 

DATAP : 

DATA: BLOCK 1 

TABLS": BLOCK 128 



;PUT LITERALS IN HIGH SEG 

;DATA AREA: 

^START DATA AREA AT 140 IN LOW SEG 

s IF REENTRANT 

JFIRST LOCATION CLEARED EVERY STARTUP 



DATAF: 



END 



BEG 



;DEFINE FREE LOCATION 
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Appendix D 
Device Status Bits 



Table D-l 
Device Status Bits 



Devict 


i Function 
SETSTS 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 


32 


33 


34 


35 


CDP 
























DEC 

029 

Card 




User 

Word 

Count 


Data Mode 




GETSTS 




Punch 
Error 




Data 
when 
EOC 
reaches 


i 


I/O 
Active 












Codes 








CDR 


SETSTS 


























Sync 
Input 




Data Mode 




GETSTS 


No 
7-9 
Punch 


Data 
Missed 


Binary 
Check' 
sum 
Error 




EOF 
card 
EOF 

button 


I/O 
Active 


















DIS 


SETSTS 
GETSTS 












I/O 
Active 


















Data Mode 


DSK 


SETSTS 


























Sync 
Input 


User 
Word 
Count 


Data Mode 




GETSTS 


Write 
Lock 


Search 
Error 


Parity 
Check- 
sum 


Block 
No. 
Too 
Large 


End 

of 

File 


I/O 
Active 



















Table D-I (cont) 
Device Status Bits 



O 
10 



Device Function 



DTA SETSTS 



GETSTS 



LPT SETSTS 



GETSTS 



MTA SETSTS 



GETSTS 



PLT SETSTS 



GETSTS 



PTP 



PTR 



SETSTS 
GETSTS 

SETSTS 
GETSTS 



18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 


32 


33 


34 


35 
























Non- 


Sync 


User 


Data Mode 
























struc- 


Input 


Word 


























tured 




Count 


























Dump 






























Mode 








Write 


Data 


Parity 


Block 


End 


I/O 




















Lock 


Missed 


Error 


No. 
Too 
Large 


of 
File 


Active 
I/O 
















User 
Word 
Count 


Data Mode 












Active 






Write 

Even 

Parity 


Tape Density 


No 
Retry 


Sync 
Input 


User 

Word 

Count 


Data Mode 


Write 


Data 


Parity 


Record 


End 


I/O 


Load 


End 
















Lock 


Missed 


Error 


Too 


of 


Active 


Point 


Point 
















Illegal 






Long 


File 




Rewind- 
















Opera- 












ing 


















tion 










I/O 
Active 

I/O 
Active 














Sync 
Input 


User 
Word 
Count 

User 

Word 

Count 


Data Mode 

Data Mode 
Data Mode 


Block 




Check- 




End 


I/O 




















Incom- 




sum 




of 


Active 




















plete 




Error 




Tape 























Table D-l (Cont) 
Device Status Bits 



Device Function 



PTY SETSTS 
GETSTS 



TTY SETSTS 



GETSTS 



18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 


32 


33 


34 


35 






























Data Mode 










Block 




I/O 


PTY 


TTY 


Monitor 




















No. 




Active 


Wait 


Re- 


Mode 






















Too 








sponse 
























Large 












Echo 
of $ 
Sup- 
press 


Echo 
Sup- 
press 


Full 
Char- 
acter 
Set 


Sync 
Input 


User 

Word 

Count 


Data Mode 






Ignore 


Echo 


Char- 




























Inter- 


Fail- 


acter 




























rupt 


ure 


Lost 



























Note 1: SETSTS UUO may set all bits except Bit 23 and GETSTS UUO may return all bits (18-35); however, the two are separated to show those bits nor- 
mally set by the user program on INIT, OPEN, or SETSTS as distinct from those normally set by the monitor (GETSTS). 
Note 2: Unused bits should always have the value 0. 
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Appendix E 
Error Codes 



The following error codes (refer to Table E-l) are returned in AC on RUN and GETSEG UUOs, in 
location E + 1 on 4-word argument blocks of LOOKUP, ENTER, and RENAME UUOs, and in the right 
half of location E +3 on extended LOOKUP, ENTER, and RENAME UUOs. The codes are defined in 
the S.MAC monitor file. 



Table E-l 
Error Codes 



Symbol 


Code 


Explanation 


.ERFNF 





File not found, illegal filename (0,*), or filenames do not 
match (UPDATE). 


.ERIPP 


1 


Incorrect project-programmer number. (UFD does not exist.) 


.ERPRT 


2 


Protection failure or directory full on DTA. 


• ERFBM 


3 


File being modified (ENTER). 


.ERAEF 


4 


Already existing filename (RENAME) or different filename 
(ENTER after LOOKUP). 


.ERISU 


5 


Illegal sequence of UUOs (RENAME with neither LOOKUP 
nor ENTER, LOOKUP after ENTER). 


.ERTRN 


6 


a. Transmission, device, or data error (RUN, 
GETSEG only). 

b. Hardware-detected device or data error 
detected while reading the UFD RIB or UFD 
data block . 

c. Software-detected data inconsistency error 
detected while reading the UFD RIB or file RIB. 


.ERNSF 


7 


Not a saved file (RUN, GETSEG only). 


• ERNEC 


10 


Not enough core (RUN, GETSEG only). 


.ERDNA 


11 


Device not available (RUN, GETSEG only). 


.ERNSD 


12 


No such device (RUN, GETSEG only). 
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Table E-l (Cont) 
Error Codes 



Symbol 


Code 


Explanation 


.ERILU 


13 


Illegal UUO (GETSEG only). No two-register relocation 
capability. 


.ERNRM 


14 


No room on this file structure or quota exceeded (over- 
drawn quota not considered) . 


.ERWLK 


15 


Write-lock error. Cannot write on file structure. 


.ERNET 


16 


Not enough table space in free core of monitor. 


.ERPOA 


17 


Partial allocation only. 


.ERBNF 


20 


Block not free on allocated position. 
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Appendix F 

Monitor Diagnostic Messages 



The following table contains a summary of the diagnostic messages that the system can issue. The 
conventions used in the summary are: 

dev represents any legal device name, 

file.ext represents any legal filename and filename extension, 

adr represents a user address. 

I n represents a number, usually a job number or device unit number, 

unit represents any legal disk unit. 

| Programs and commands causing the error message are given in parentheses. 



Table F-l 
Monitor Diagnostic Messages 



The typein is typed back preceded and followed 
by ? 



ACTIVE SWAPPING LIST FULL 



?ADDRESS CHECK FOR DEVICE dev 



?ALREADY ASSIGNED TO JOB n 



The monitor encountered an incorrect character 
(e.g., a letter in a numeric argument). The in- 
correct character appears immediately before the 
second ?. 

For example: 

. CORE ABC 
? CORE A ? 

An attempt was made to specify more units to 
the active swapping list than the monitor tables 
can handle. The current limit is 8. If the oper- 
ator needs more swapping space, he should in- 
crease the amounts on the eight units already 
specified. (ONCE ONLY). 

The monitor checked n user address on a UUO and 
found it to be too large (>C(JOBREL)) or too small 
(<JOBPFI); in other words, the address lies out- 
side the bounds of the user program. 

The device is already assigned to another user's 
job (job n) . 
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?ARGSARE: DAY, RUN, WAIT, READ, 
WRITE 


The user typed an illegal argument in the WATCH 
command string. 


?BAD DIRECTORY FOR DEVICE DTAn 


The system cannot read or write the DECtape 
directory without getting some kind of error. 
This error often occurs when the user tries to write 
on a write-locked tape or use a DECtape that has 
never been written on. 


BLOCK NOT FREE 


M specifies a unit or file structure logical block 
that is not free. 


?BUSY 


The console addressed is not communicating with 
the monitor. The operator's console is never busy. 
(SEND). 


CANNOT EXCEED ' BLOCKS IN RLE 
STRUCTURE = m 


The number of disk blocks specified for reserved 
quotas or the number of disk blocks specified for 
the overdraw amount was too large. The operator 
should type in a number less than or equal to m. 
(ONCE ONLY). 


CANNOT EXCEED * SAT BLOCKS 
ON UNIT = n 


The number of SAT blocks in core cannot exceed 
the number of SAT blocks (n) on the unit. The 
operator should type a number less than or equal to 
n. (ONCE ONLY). 


?CAN'TATTTO JOB 


The project-programmer number specified is not 
that of the owner of the desired Job or is not [1 ,4] . 


?CAN'T CONTINUE 


The job was terminated due to a monitor-detected 
error and cannot be continued . 


CAN'T CREATE NEW FILE STRUCTURE SEARCH 
LIST 


The monitor cannot create a new file structure 
search list. 


?CAN'T DECIPHER THAT 


There is a syntax error in the command string. 
(MOUNT, DISMOUNT, FILE). 


?CAN*TFIND FILE file.ext 


The specified file could not be found. 


?CAN'T DET DEV 


The user is not logged-in under [1 .4] . 


COMMAND ERROR 


General catch-all error response for the COMPIL 
commands. The syntax of the command is in error, 
and the command cannot be deciphered. (COMPIL) 


[CREATING NEW FILE] 


The specified file does not exist; therefore a MAKE 




command is assumed . 


dev: ASSIGNED 


The device has been successfully assigned to the 




user's job. 


7DEVICE CAN'T BE REASSIGNED 


A user's Teletype cannot be reassigned, or an 
attempt was made to reassign a device that a job is 
still using. 
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?DEVICEdevOK? 



?dev WASN'T ASSIGNED 

?DEVICEdev NOT AVAILABLE 

DISMOUNT COMPLETE 
DPAn NOT AVAILABLE 

DPAn NOT READY 



DPA IS OFF-LINE 

DO YOU WANT IT TO BE 1) ON-LINE OR 

2) DOWN? (TYPE *) 



DPAO IS OFF-LINE 

DO YOU WANT IT TO BE 1) ON-LINE, 

2) OFF-LINE, OR 3) DOWN? (TYPE *) 



DPAO IS WRITE PROTECTED. DO YOU WANT 
IT TO BE I) WRITE- ENABLED, OR 2) WRITE- 
PRO TECTED? 



?ENTER FAILURE 



The device is temporarily disabled. The line 
printer may be turned off or out of paper. For 
magnetic tapes, no tape is mounted or the switch 
is in LOCAL. The user should correct the situa- 
tion and then proceed (retry the operation) by 
typing CONTINUE. 

The device is not currently assigned to the user's 
job and cannot be deassigned or reassigned by the 
job. 

Specified device cannot be initialized because 
another user is using it. (COMPIL) 

The DISMOUNT command has completed. 

The drive indicated by the user is not currently 
available. (MOUNT). 

The indicated drive is either off-line or physically 
write-locked when write-enabled was requested. 
The operator will be notified. (MOUNT). 

Controller DPA (RP10) is off-line. The operator 
should check settings of all switches in RP10 bay. 
All switches should be down. After changing 
switches, the operator should type 1 . If the 
operator does not want the monitor to use the con- 
troller, he should type 2. Also applies to DPB. 
(ONCE ONLY). 

The operator should check the START/STOP rocker 
switch and the ENABLE/DISABLE switch on the in- 
dividual disk pack unit. They should be in the 
normal position with the top of the switch in. 
After changing switches, the operator should 
type 1 . If the operator does not want the monitor 
to use the unit, he should type 2. This message 
also applies with DPA1 , DPA2. . . ,DPA7, DPBO, 
DPB1,...,DPB7. (ONCE ONLY). 

Disk pack unit DPAO is on-line, but is write- 
protected. If the operator wishes it to remain this 
way, he should type 2. Otherwise he should set 
the READWRITE/READ ONLY rocker switch to 
normal (top of switch in) and then type 1 . This 
message also applies with DPA1 , . . . ,DPA7, DPBO, 
DPB1,...,DPB7. (ONCE ONLY). 

The ENTER to write the file failed. The error code 
may be seen by examining location 1 . 
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TERROR IN JOBn 



9EXCEED LOG-OUT m QUOTA BY n BLOCKS 



EXECUTION DELETED 



FHA IS OFF-LINE 

DO YOU WANT IT TO BE 1) ON-LINE OR 2) 

DOWN? (TYPE *) 



FHAO is OFF-LINE 

DO YOU WANT IT TO BE 1) ON-LINE, 2) 

OFF-LINE, OR 3) DOWN? (TYPE *) 



file.ext FOUND BAD BY FAILSAFE READING 
MTA 

file.ext HARDWARE DATA READ ERROR 
DETECTED 

file.ext HARDWARE DATA WRITE ERROR 
DETECTED 

?file.ext NOT FOUND 

file.ext SOFTWARE CHECKSUM OR 
REDUNDANCY ERROR 



A fatal error occurred in the job or in the monitor 
while servicing the job. This typeout usually pre- 
cedes a one-line description of the error. 

The total number of blocks for all the user's files 
exceeds the maximum permitted value (m) by the 
indicated amount n. The user may use PIP or the 
DELETE command to remove files. Until the user 
is under the limit, he cannot dismount the file 
structure. (DISMOUNT). 

A program is prevented from being executed be- 
cause of errors detected during assembly, compila- 
tion, or loading. Loading is performed, but the 
loader exits to the monitor without starting exe- 
cution. (LOADER). 

Controller FHA (RC-10) is off-line. The operator 
should check settings of all switches in RC-10 bay. 
All switches should be down. After changing 
switches, the operator should type 1 . If the oper- 
ator does not want the monitor to use the control- 
ler, he should type 2. Also applies to FHB. 
(ONCE ONLY). 

The operator should check the unit dial selectors. 
One of them (DISK A, DISK B, DISK C, or DISK 
D) should be set to 0. The operator should set the 
switches for all the units he has to 0, I, 2, 3. 
The other units should be OFF. The operator 
should not touch any dials which are dialed to 
numbers numerically less than the one just typed 
out, since the monitor has already read these units. 
After changing the switches and dials, the operator 
should type 1 . If the unit is temporarily down and 
will be fixed while the system runs, he should type 
2. In all other cases, he should type 3. Could 
apply to FHA1 , . . . , FHA3 , FHBO, . . . , FHB3 . 
(ONCE ONLY). 

The file in the file structure has an error status as 
flagged in the UFD of the file structure. (LOGIN). 

The file has a hardware data read error flagged in 
the UFD of the file structure. (LOGIN). 

The file has a hardware data write error flagged in 
the UFD of the file structure. (LOGIN) . 

The program file requested cannot be found on the 
system device or the specified device. 

The file has an error as flagged in the UFD of the 
file structure. (LOGIN). 
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FILE IN USE OR PROTECTED 

?FILENAME ALREADY IN USE 

FIRST BAT BLOCK CONSISTENCY ERROR 



FIRST BAT BLOCK HARDWARE ERROR 



FIRST HOM BLOCK CONSISTENCY ERROR 



FIRST HOM BLOCK HARDWARE ERROR 



FROM JOB n 

fs MOUNT COMPLETE 
?HALTATUSERadr 

?HUNG DEVICE dev 



?ILLEGAL DATA MODE FOR DEVICE dev 
AT USER adr 



A temporary command file could not be entered in 
the UFD (user's file directory). (COMPIL). 

The specified file already exists. (COMPIL). 

The ONCE ONLY dialog has discovered that the 
first of two redundant BAT blocks does not contain 
some of the data normally expected in a BAT 
block. This is not a fatal error since the other BAT 
block is probably all right. If both BAT blocks 
have this error, the operator should initialize the 
BAT blocks. This error may occur if some of the 
diagnostics are run . (O NC E O NLY) . 

The ONCE ONLY dialog has had a hardware error 
while reading the first of two redundant BAT blocks 
Since there is another BAT block, this error is 
usually not fatal . The controller status is put in 
the consol e I ights . (O NC E O NLY) . 

The ONCE ONLY dialog has discovered that the 
first of two redundant HOM blocks does not con- 
tain some of the data normally expected in a HOM 
block. Therefore, none of the data should be con- 
sidered valid. This is not a serious error since the 
other HOM block is usually all right. If both 
HOM blocks have consistency errors, the operator 
has to dissolve the file structures, redefine, and 
refresh. (ONCE ONLY). 

The ONCE ONLY dialog has had a hardware error 
while reading or writing the first of two redundant 
HOM blocks. This is not fatal since there is 
another HOM block. The controller status is put 
in the console lights, and the controller is left in 
its error condition. (ONCE ONLY) . 

An informative message telling the user the job 
number to which the console was attached or from 
which the console is detaching. (ATTACH, DE- 
TACH). 

The file structure (fs) is mounted and ready for use; 
the MOUNT command is complete. (MOUNT). 

The user's program executed a HALT instruction at 
adr. Typing CONTINUE resumes execution at the 
effective address of the HALT instruction. 

If a device does not respond within a certain period 
after it is referenced, the system decides that the 
device is not functioning and outputs this message. 

The data mode specified for a device in the user's 
program is illegal , such as dump mode for 
Teletype. 
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?ILLEGAL DRIVE DPAn 

?ILLEGAL JOB NUMBER 
7ILLEGAL UUO AT USER adr 
?ILL INST. AT USER adr 

?ILL MEM REF AT USER adr 

?INPUT DEVICE dev CANNOT DO OUTPUT 
AT USER adr 

INPUT ERROR 

?INPUT FILE NOT FOUND 
?INVALID ENTRY - TRY AGAIN 

?l/0 TO UNASSIGNED CHANNEL AT USER 
adr 

?JOB CAPACITY EXCEEDED 



JOB SAVED 

LAST UNIT WASN'T FOUND IN STR DSKn 



LINKAGE ERROR 



?LOCK ED-OUT BY OPERATOR 



7LOGICAL NAME ALREADY IN USE, 
DEVICE dev ASSIGNED 



The drive specified by the user is in conflict with 
the unit or controller type required by the units of 
the file structure. (MOUNT). 

The job number is too large. 

An illegal UUO was executed at user location adr. 

An illegal operation code was encountered in the 
user's program . 

An illegal memory reference was made by the user's 
program at adr or adr + 1 . 

Output was attempted on a device that can only 
do input (e.g., the card reader). 

I/O error occurred while reading a temporary com- 
mand file from the disk . File should be rewritten. 
(COMPIL). 

The specified file does not exist. (COMPIL). 

An illegal project-programmer number or password 
was entered and did not match identification in 
system. (LOGIN). 

An attempt was made to do an OUTPUT, INPUT, 
OUT, or IN to a device that the user's program 
has not initialized. 

This message is received by the first user who 
attempts to LOGIN after the maximum number of 
jobs that the system has been set to handle has 
been initiated. (LOGIN). 

The output is completed. 

The last unit in the file structure is missing. The 
operator should check to see that all the proper 
packs are mounted and on-line. If not, he should 
remount them and restart the monitor at 140. 
Otherwise, the operator has to dissolve the file 
structure, redefine it, and then refresh it, thereby 
destroying any data already on the unit. 
(ONCE ONLY). 

An I/O error occurred while reading a CUSP from 
device SYS:. (COMPIL). 

The operator is preventing any new accesses to the 
file structure in order that it may be removed. 
(MOUNT). 

The user previously assigned this logical name to 
another device. The device is assigned but the 
logical name is not. 
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LOGICAL STR #n MISSING FROM "SYS" 
SEARCH LIST 



LOGICAL UNIT n MISSING FROM ACTIVE 
SWAPPING LIST 



LOGICAL UNIT n MISSING FROM STR DSKn 



?LOGIN PLEASE 



MORE THAN ONE LAST UNIT IN ACTIVE 
SWAPPING LIST 



MORE THAN ONE LAST UNIT IN STR DSKn 



MOUNT COMPLETE 



?MOUNT UNSUCCESSFUL 



?MUST BE IN OWNER'S PROJECT FOR 
SINGLE ACCESS 



n BLOCKS ALREADY ALLOCATED 



A file structure is missing from the SYS search list. 
This condition need not be corrected, since the 
monitor will skip the missing file structure. To 
avoid the message in the future, the operator 
should change the SYS search list when asked. 
(ONCE ONLY). 

A unit is missing from the active swapping list. 
This can happen if a unit is off-line or down. This 
error need not be corrected since the monitor will 
order the swapping list accordingly. (ONCE 
ONLY). 

A unit is missing from a file structure and must be 
remedied. The operator should check that all 
proper packs are mounted and on-line. If this is 
not so, the operator should add the proper packs 
and restart the monitor at 140. Otherwise he has 
to dissolve the file structure, redefine it, and re- 
fresh it, thereby destroying any data already on the 
unit. (ONCE ONLY). 

A command that requires the user to be logged in 
has been typed to the monitor; it cannot be accept- 
ed until the user performs a LOGIN. 

The active swapping list specified in the disk unit 
HOM blocks has more than one unit as the last one. 
The operator should redefine the units in the active 
swapping list to correct this situation. (ONCE 
ONLY). 

The file structure has more than one unit specified 
as the last unit as recorded in the disk home blocks. 
The operator should dissolve the file structure and 
redefine it. (ONCE ONLY). 

The file structure is mounted and ready for use. 
(MOUNT). 

The MOUNT command has not completed success- 
fully. In most cases, the reasons for failure have 
already been listed by non-error messages. 

The user may not request single-access (/SINGLE 
switch) unless he has the same project number as 
the owner of the file structure. This requirement 
is enforced since a user with single access may exe- 
cute super-USETl/USETO UUOs. (MOUNT). 

The file already exists. The new specification 
replaces the old specification rather than updating 
the old one. 
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NESTING TOO DEEP 



NEW UFD CREATED ON STRUCTURE RE- 
SERVED (n) F.C.F.S. (n) LOGGED-OUT (n) 



?nK OF CORE NEEDED 

?nlK BLOCKS OF CORE NEEDED 

?NO CORE ASSIGNED 

NONE PENDING 

7NON-EXISTENT DRIVE DPAn 

7NON-EX MEM AT USER adr 
?NO START ADR 

?NO SUCH DEVICE 

NO SUCH FILE file. ext 

?NO SUCH JOB 

NO SUCH UNIT 

?NO SUCH TTY 

?NOT A SAVE FILE 
NOT A FILE STRUCTURE 

?NOTA JOB 

NOT ENOUGH CORE 

NOT ENOUGH DRIVES 



The @ construction exceeds a depth of nine and 
may be due to a loop of @ command files. 
(COMPIL). 

An initial UFD has been created on the file struc- 
ture for the user. The numbers are block quotas 
as established by QUOTA. SYS for this file struc- 
ture. (MOUNT). 

There is insufficient free core to load the file. 

The user's current core allocation is less than the 
contents of JOBFF. 

No core was allocated when the GET command 
was given and no core argument was specified in 
the GET. 

None of the user's requests to the operator are 
pending . 

The user has specified a drive that does not exist 
in the system. (MOUNT). 

Usually due to an error in the monitor. 

Starting address or reenter address is zero, because 
the user failed to specify the starting address. 

The device name does not exist or all devices of 
this type are in use. 

Specified file could not be found. Could be a 
source file or a file required for operation of the 
COMPIL commands. (COMPIL). 

An attempt was made to attach to a job that has not 
been initialized. 

The unit does not exist or all units of this type are 
in use. 

The console number is not part of the system con- 
figuration. 

The file is not a core image file. 

The file structure specified is not recognized by 
the monitor. 

The job number is not assigned to any currently 
running job. 

System cannot supply enough core to use as buffers 
or to read in a CUSP. (COMPIL). 

There are currently not enough drives of the right 
type to mount the file structure. (MOUNT). 
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NO UNITS IN ACTIVE SWAPPING LIST 



OPERATOR BUSY, HANG ON PLEASE. 



OPERATOR HAS BEEN NOTIFIED. 



OPERATOR REQUESTED TO MOUNT UNITS 



OPERATOR REQUESTED TO READY DRIVES 



OPERATOR REQUESTED TO REMOVE PACKS 



OTHER USERS - CANNOT SINGLE ACCESS 



OTHER USERS - CAN'T REMOVE 



?OUT OF BOUNDS 



?OUTPUT DEVICE dev CANNOT DO INPUT 
ATUSERadr 

OUTPUT ERROR 



PAUSE. . . (tC TO QUIT, CR TO CONT) 



?PC OUT OF BOUNDS AT USER adr 



None of the on-line units are in the active swap- 
ping list. Since there must be swapping space, the 
operator must change the active swapping list to 
include a unit which has some swapping space. If 
there are no units with swapping space, the opera- 
tor must define swapping space on a unit not in a 
file structure. If all units are in file structure, the 
operator must refresh a file structure, define the 
necessary swapping space, and redefine the active 
swapping I ist . (O NC E O NLY) . 

The user must wait for the operator to become 
available. 

The operator is available and the user may continue 
typing his message. 

A request is queued to the operator to mount and 
ready the packs on the proper drives. (MOUNT). 

One or more drives (as specified by previous mes- 
sages) are not ready. A request is queued to the 
operator. (MOUNT). 

A request to physically remove the packs has been 
queued to the operator. (DISMOUNT). 

Other users are currently using the file structure 
that has been specified with the single-access 
switch G/SINGLE). The switch is ignored. 
(MOUNT). 

A DISMOUNT command requesting physical removal 
(/REMOV switch) of a pack has been issued and 
there are other users of the pack. The switch is 
ignored. (DISMOUNT). 

The specified adr is not in the user's core area, or 
the high segment is write- protected and the user 
does not have privileges to the file that initialized 
the high segment. 

An attempt was made to input from an output device 
(e.g., the line printer). 

An I/O error occurred while writing a temporary 
command file on disk. (COMPIL). 

The PAUSE switch has been specified, and an 
operator action is about to be requested. tC 
aborts the command before the request is queued to 
the operator. Carriage return-line feed allows the 
command to continue, and the request Is queued to 
the operator. 

An illegal transfer has been made by the user pro- 
gram to user location adr. 
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?PLEASE TYPE tC FIRST 



PROCESSOR CONFLICT 



7PLEASE KJOB OR DETACH 



SAT BLOCK HARDWARE ERROR 



SECOND BAT BLOCK CONSISTENCY ERROR 



SECOND HOM BLOCK CONSISTENCY ERROR 



SECOND HOM BLOCK HARDWARE ERROR 



7SINGLE-ACCESS BY JOB n 



STRUCTURE ALREADY MOUNTED 



?STRUCTURE NOT IN STRLST. SYS 



?SWAP READ ERROR 



A command which would start a job has been issued 
after a C START or CCONT. 

Use of + construction has resulted in a mixture of 
source languages. (COMPIL). 

Attempt was made to LOGIN a job when the user 
already has a job initialized at that Teletype. 

The ONCE ONLY dialog has had a hardware error 
while reading one of the SAT blocks. (ONCE 
ONLY). 

The ONCE ONLY dialog has discovered that the 
second of two redundant BAT blocks does not con- 
tain some of the data normally expected in a BAT 
block. This is not a fatal error since the other 
BAT block is probably all right. If both BAT blocks 
have this error, the operator should initialize the 
BAT blocks. This error may occur if some of the 
diagnostics are run. (ONCE ONLY). 

The ONCE ONLY dialog has discovered that the 
second of two redundant HOM blocks does not con- 
tain some of the data normally expected in a HOM 
block. Therefore, none of the data should be con- 
sidered valid. This is not a serious error since the 
other HOM block is usually all right. If both HOM 
blocks have consistency errors, the operator has to 
dissolve the file structures, redefine and refresh. 
(ONCE ONLY). 

The ONCE ONLY dialog has had a hardware error 
while reading or writing the second of two redun- 
dant HOM blocks. This is not fatal since there is 
another HOM block. The controller status is put 
in the console lights, and the controller is left in 
its error condition. (ONCE ONLY). 

The file structure is already single access by the 
indicated user. (MOUNT). 

The requested file structure is already mounted, but 
may not be in a readied state. (MOUNT). 

The file structure name does not exist in the system 
administrator's file SYS: STRLST. SYS, and therefore 
is not defined for the system. The operator or ad- 
ministrator may be requested to define the file 
structure by adding it to STRLST. SYS with the 
REACT CUSP. (MOUNT). 

A consistent checksum error has been encountered 
when checksumming locations JOBDAC through 
JOBDAC+74 of the job data area during swapping. 
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?SYNTAX ERROR 
?SYSTEM ERROR -xxxxxx 

?TOO FEW ARGUMENTS 
TOO MANY FILE STRUCTURES 



TOO MANY NAMES or TOO MANY 
SWITCHES 

TOO SMALL - MIN. # = X 



7TRANSMISSION ERROR 



?TRY LARGER ARG 

?TTYn ALREADY ATTACHED 

TWO LOGICAL UNIT n's FOUND IN ACTIVE 
SWAPPING LIST 

TWO LOGICAL UNIT n's FOUND IN STR DSKn 



TWO LOGICAL STR n's FOUND IN "SYS" 
SEARCH LIST 



UFD QUOTAS CHANGED, RESERVED (n) 
F.C.F.S (n) LOGGED-OUT (n) 



?UNDEFINED SWITCH switch 



There is a syntax error in the command string. 

System errors designate operator or system errors 
and are not a direct fault of the user. They are 
typed for possible diagnostic use. 

A command has been typed, but necessary argu- 
ments are missing. 

The number of file structures exceeds the capacity 
of the monitor data base. The current limit is 
14 . (ONCE ONLY). 

Command string complexity exceeds table space in 
the COMPIL CUSP. (COMPIL). 

An answer to the ONCE ONLY dialog or a default 
value is too small . Type in an answer greater than 
or equal to X. 

During a SAVE, GET, or RUN command, the system 
received parity errors from the device, or was un- 
able to read the user's file in some other way. 
This can be as simple as trying to write on a write- 
locked tape. 

The specified argument is too small for the program. 

Job number is erroneous and is attached to another 
console, or another user is attached to the job. 

The active swapping list has more than one unit in 
the same position. The operator must redefine the 
active swapping list. (ONCE ONLY). 

Two units are marked to be in the same logical 
position in the file structure. This happens only if 
two different file structures have been given the 
same name. The operator should try to remove the 
pack that does not belong and then restart the moni- 
tor at 140. Otherwise, he has to dissolve DSKn, 
redefine it and refresh it. (ONCE ONLY). 

Two file structures are marked to be in the same 
position in the SYS search list. The operator should 
change the SYS search list when asked. Refreshing 
is not required . (ONCE ONLY). 

The block quotas on this file structure as establish- 
ed by QUOTA. SYS have changed since the user's 
last use of the file structure. The user's UFD will 
be changed to specify the indicated quotas. 
(MOUNT). 

The specified switch is either undefined or not 
unique. (MOUNT, DISMOUNT). 
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unit 

# BAD REGIONS = m 

' BAD BLOCKS = n 

DO YOU WANT TO INITIALIZE THE BAD 

BLOCKS ON THIS UNIT? 



UNIT ALREADY IN ACTIVE SWAPPING LIST 



UNIT ALREADY IN FILE STRUCTURE 



UNIT id ALREADY MOUNTED ON DRIVE DPAn 

UNIT HAS NO SPACE ALLOCATED FOR 
SWAPPING 



UNRECOGNIZABLE SWITCH 



?UUO ATUSERadr 



WAITING. 



The operator should answer with N or a carriage 
return to leave the BAT blocks alone on this unit. 
The only time the operator should initialize is the 
first time the disk is written, since the blocks con- 
tain the accumulated information about bad sectors. 
If the operator answers Y, the ONCE ONLY dialog 
responds with NOT NORMALLY DONE, ARE YOU 
SURE?. Answer Y only if this important data is to 
be erased. (ONCE ONLY). 

An attempt was made to specify a unit to be in the 
active swapping list more than once. The operator 
should type a different unit name to be in the ac- 
tive swapping list. If the operator has included the 
unit name earlier by mistake, he will have another 
chance to change the active swapping list. 
(ONCE ONLY). 

An attempt was made to specify a unit to be in more 
than one file structure. The operator should type a 
different unit name to be in this file structure. If 
the operator has included the unit in an earlier file 
structure by mistake, he will have to dissolve it. 
(ONCE ONLY). 

The file structure is already mounted but is on 
different drives than the user specified. (MOUNT). 

An attempt has been made to specify a unit which 
has no swapping space allocated to be part of the 
active swapping list. The unit is not added to the 
list. The operator should do one of the following: 

1) specify another unit, 

2) type an extra carriage return signifying com- 
pletion, 

3) define swapping space for a unit not in a 
file structure, 

4) change the swapping space for a unit in a 
file structure and refresh it. (ONCE ONLY). 

An ambiguous or undefined word has been preceded 
by a slash. (COMPIL). 

This message accompanies many error messages and 
indicates the location of the UUO that was the last 
instruction the user program executed before the 
error occurred . 

A request has been queued to the operator and the 
command is waiting for completion of the necessary 
action . If the user does not want to wait for con- 
firmation, he may type control-C. (MOUNT, 
DISMOUNT). 
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?WASN'T DET 


The specified device is not detached. 


X 


If the system is fully loaded any user (after the 
first user) who attempts to LOGIN receives this 
character in response to any character typed. 
(LOGIN). 


?l+lnKCORE 
VIR. CORE LEFT = 


The swapping space or the core allocated to time- 
sharing is all in use (i.e., there is no available 
virtual core). 
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Appendix G 
Filename Extensions 



Table G-1 
Filename Extensions 



Filename Extension 


Meaning 


AID 


Source file in AID language 


ALG 


Source file in ALGOL language 


ALP 


Printer forms alignment 


BAK 


Backup file from TECO or LINED 


BAS 


Source file in BASIC language 


BIN 


Binary file 


BLI 


Source file in BLISS language 


CAL 


CAL data and program files 


CBL 


Source file in COBOL language 


CCL 


Alternate convention for command file (@ construction 
for CUSPs other than COMPIL) 


CKP 


Checkpoint core image file created by COBOL 
operating system 


CMD 


Command file for indirect commands (@ construction 
for COMPIL) 


COR 


Correction file for SOUP 


CRF 


CRE (cross-reference) input file 


CTL 


MP batch control file 


DAE 


Default output for DAEMON-taken core dumps 


DAT 


Data (FORTRAN) file 


DCR 


Core image save (DCORE) 


DDT 


Input file to FILDDT 


DIR 


Latest directory from FILE command for this DECtape 


DMP 


PDP-6 format for a file created by a SAVE command 
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Table G-l (Cont) 
Filename Extensions 





Filename Extension 


Meaning 




DOC 


Listing of modifications to software 




F4 


Source file in FORTRAN language 




FRM 


Form 


1 


FUD 


FUDGE2 listing output 




HGH 


Nonsharable high segment 




HLP 


Help files containing switch explanations 




LOG 


MP batch log file 


1 
i 


LOW 


Low segment of a two-segment program 


LSD 


Default output for DUMP CUSP 


LSQ 


Queue listing 




LST 


Listing data 




MAC 


Source file in MACRO language 




MAN 


Manual (documentation) file 




MAP 


Loader map file 




MEM 


Memorandum file 


1 


MSB 


Music compiler binary output 


1 


MUS 


Music compiler input 




OPR 


Instal 1 ation i nstructions 




OVR 


COBOL overlay file 




PAL 


Source file in PAL 10 (PDP-8 assembler) 




PBT 


P-batch control file 




PLG 


P-batch log file 




QUE 


Queue (MPB) control or data file 




REL 


Relocatable binary file 




RIM 


RIM loader file 




RMT 


Read-in mode (RIM) format file (PIP) 




RNO 


RUNOFF input Hie 




RSP 


Script response time log file 




RTB 


Read-in mode (RIM10B) format file (PIP) 




SAV 


Low segment from a one-segment program 




SCP 


SCRIPT control file 


1 


SFD 


Sub-file directory 
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Filename Extension 



SHR 

SYS 

TEC 

TMP 

TXT 

UFD 

UPD 

WCH 

XPN 



Table G-l (Cont) 
Filename Extensions 



Meaning 



Sharable high segment file 

Special system files 

TECO macro 

Temporary files 

Text file 

User file directory 

Updates flagged in margin (SRCCOM) 

SCRIPT monitor (WATCH) file 

Expanded save file (FILEX) 



Revision 1 Monitors 



G-3 



January 1971 



Appendix H 

Comparison of 
Disk-Like Devices 



Table H-l 
Disk Devices 



Device Name 

Manufacturer 
Device Type 


Fixed-Head 
disk 


Drum 


Removable 


disk pack(s) 


Mass disk 
file 


Movable head 
disk 


Burroughs 
RD10 


Bryant 
RM10B 


Memorex 


Bryant 
RB10B 


Data -Products 
270 


RP01 


RP02 


Controller 


RC10 


RC10 


RP10 


RP10 


RA10 


- 


Maximum 
Disks per 
Controller 


4 


4 


8 


8 


1 


4 


Maximum 
Controller 
per System 


2 






2 


2 





Hardware 
Mnemonic 


DSK 


DSK 


DPC 


DPC 


MDF 


DF 


Software 
Mnemonic 


FHA,FHB 


FHA,FHB 


DPA,DPB 


DPA,DPB 


MDA,MDB 




Capacity 
Minimum 
(XI 0**6 words) 


.5 


.345 


1.3 


5.2 


21 


5.7 


Maximum 
(1 control) 
0(1**06 words) 


2 


1.38 


10.1 


41.4 


104.8 


23 


Blocks/Track 


20 


30 


5 


10 


64 




Blocks/Cylinder 


4000 


2700 


50 


200 


300,1600 




Blocks/Unit 


4000 


2700 


10150 


40600 


163840,819200 




Rotational 
Speed (rpm) 


1800 


3600 


2400 


2400 


1200 


1200 


Revolution 
Time (msec) 


33 


17 


25 


25 


50 


50 


128-Word Blocks/ 
Revolution 


20 


30 


5 


10 


16,11,5 


7.4 


Transfer Rate 
usee word 


13 


4.3 


30 


15 


23,32,72 


51.8,88 
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Table H-l (Cont) 
Disk Devices 



Device Name 

Manufacturer 
Device Type 


Fixed -Head 
disk 


Drum 


Removable disk pack(s) 


Mass disk 
file 


Movable head 
disk 


Burroughs 
RDIO 


Bryant 
RMIOB 


Memorex 


Bryant 
RBI 0B 


Data -Products 
270 


RP01 


RP02 


Controller 


RC10 


RC10 


RP10 


RP10 


RA10 


- 


Seek Time 
Average (msec) 








50 


50 


110 


175 


Minimum (msec) 








20 


20 


50 


80 


Maximum (msec) 








80 


80 


180 


225 


Swapping Times 






(Includes 30 ms verify) 






(msec) 
IK 


25 


13 


95 


84 


175 


262 


4K 


73 


27 


225 


144 


284 


454 


10K 


154 


54 


490 


264 


502 


1062 


25 K 


358 


T20 


T165 


589 


1048 


2462 



NOTE 

The dual-positioning Bryant disk is not supported by 
DEC software, only the single-positioning disk is 
supported. Although the Bryant drum is a drum in 
every sense, its software mnemonic is still FHA be- 
cause it is connected to the system through the fixed 
head disk control . 
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Appendix I 
Retrieval Pointers 



Sequential and random file access is handled more efficiently by compacting the amount of information 
necessary to describe the location of a file. Retrieval information associated with each file is stored 
and accessed separately from the data. Retrieval pointers describe contiguous blocks of file storage 
space called groups. Each pointer has one of three forms: 

a. A group pointer 

b. An EOF pointer 

c. A change of unit pointer. 

1.1 A GROUP POINTER 

A group pointer has three fields: 

a. A cluster count 

b. A folded checksum 

c. A cluster address within a unit. The width of each field may be specified at refresh 
time; therefore, the same code can handle a wider variety of sizes of devices. 

The cluster count determines the number of consecutive clusters, which can be described by one point- 
er. The folded checksum is computed for the first word of the first block of the group. Its main purpose 
is to catch hardware or software errors when the wrong block is read. The folded checksum is not a 
check on the hardware parity circuitry. The size of the cluster address field depends on the largest 
unit size in the file structure and the cluster size. A cluster address is converted to a logical block 
address by multiplying by the number of blocks per cluster. 
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1.1.1 Folded Checksum Algorithm 

This algorithm takes the low order n-bit byte, repeatedly adds it to the upper part of the word, and 
then shifts. The code is: 

LOOP: ADD T1>T 

LDB T,LOW ORDER N BITS OF Tl 

LSH TU-N ;RIGHT SHIFT BY N BITS 

JUMPtN TULOOP 

DONE i ANSWER IN T 



This scheme eliminates the usual overflow problem associated with folded checksums and terminates as 
soon as there are no more bits to add. 

1.2 END-OF-FILE POINTER 

The EOF is indicated by a zero word. 

1.3 CHANGE OF UNIT POINTER 

A file structure may comprise more than one unit; therefore, the retrieval information block must indi- 
cate which unit the logical block is on. A method of indicating a change from one unit to another 
in the middle of the file is necessary, because a file can start on one device and move to another. 
To show this movement, a zero count field indicates that the right half of the word specifies a change 
in unit. A zero count field contains a unit number with respect to the file structure. The first retrieval 
pointer, with respect to the RIB, always specifies a unit number. Bit 18 is 1 to guarantee that the 
word is non-zero; otherwise it might be confused with an EOF pointer. 
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Appendix J 

Once— Only Parameters 



The operator must invoke the optional once-only dialog when the monitor Is first loaded when file 
structure or disk unit parameters must be changed or file structures must be refreshed. When the oper- 
ator changes one or more parameters, the new values are written back onto the home blocks of the 
affected disk units. Some parameter changes require refreshing the file structures. 

J.l FILE STRUCTURE PARAMETERS 

The following file structure parameters may be changed without refreshing: 

a. Number of consecutive blocks tried for on output. 

b. Sum of the blocks guaranteed to users. 

c. Number of blocks per user allowed for overdrawing. 
I d. Inclusion and position in SYS search list. 

The following parameters may not be changed without refreshing: 
| a. NumberofK for CRASH. SAV file. 

b . Number of blocks per cluster. 

c . Number of bits per cluster count. 

J. 2 PHYSICAL UNIT PARAMETERS 

The following physical unit parameters may be changed without refreshing: 

a. Number of SAT blocks in core. 

b. Active swapping list. 

c. Swapping classes. 

The following parameters may not be changed without refreshing: 

a. Physical unit ID 

b. Logical blocks for both home blocks 
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c. K allowed for swapping on the unit 

d. First logical block for swapping 

e. Computed first logical block for swapping 

f. Number of SAT blocks per unit. 

J. 3 SYSTEM PARAMETERS 
These parameters are not rewritten on the disk: 
a. Number of monitor buffers. 
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Glossary 



Absolute Address 
Access List 

ACCT. SYS 

Active Search List 

Actual Transfer 

AUXACC. SYS 

Bad Allocation Table 
(BAT) block 

BADBLK.SYS 

Block 

Cluster 

Compressed File Pointer 

Control 

CORMAX 
CORMIN 



The address that is permanently assigned by the machine designer 
to a storage location. 

The table in core that reflects the status of all files open for read- 
ing or writing in addition to the status of those files recently 
closed. 

The file that contains all project-programmer numbers, passwords, 
and time of day users are allowed on system. It does not contain 
file structure quotas. 

An ordered list of file structures for each job, which specifies the 
order in which the directory is searched. Device DSK is defined by 
this list for each job. 

The third step of the transfer operation . The operation passes data 
between the memory system and the control . 

The file that contains the standard list of public file structures for 
each user and information, such as quotas, for those file structures. 

A block written by the MAP program or the monitor on every unit. 
This block enumerates the bad regions of consecutive bad blocks on 
that unit. The BAT blocks appear in the HOME. SYS file. 

The file that contains all bad blocks. It may be read but not de- 
leted and is useful for testing error recovery. 

A 128-word unit of storage determined by hardware and software. 
At least 128 words are written, adding zeros as necessary, although 
less than 128 words may be read. 

A possibly multiblock unit of storage assignment. 

An 18-bit pointer to the unit within the file structure and to the 
first super-cluster of the file. 

The device that controls the operation of up to eight connected 
units. It initiates simultaneous positioning commands to some of 
its units and then performs a data transfer for one of its units. 

The largest contiguous size that an unlocked job can be. This value 
can range from CORMIN to total user core. 

The guaranteed amount of contiguous core which a single unlocked 
job can have. This value can range from to total user core. 



Glossary-! 



CRASH. SAV 

Create 

Customer 
Cylinder 

Data Channel 
Device Routines 
Directory Device 

Distributed UFD 
Dormant File Structure 
Dormant Segment 
DSK 

Dump 

File Structure 



File Structure Search List 



File- Structured Device 



Filename 



Filename Extension 



FILSER 



A file written on disk as a contiguous set of blocks by a short 
routine at the crash restart location in the monitor. Used for 
analysis by file salvage program and by FILDDT for system debug- 
ging. 

To open a file for writing, write the file, and close the file for the 
first time. Only one user at a time may create a file with a given 
name and extension in the same directory of a file structure. 

A DEC customer who has a PDP-10 system as distinguished from a 
user at a console who may be purchasing time from a customer. 

The hardware-defined region of consecutive logical disk blocks, 
which can be written with one DATAO instruction. This region 
does not require positioning. 

The device that passes data between the memory system and the 
control . 

Routines that perform I/O for specific storage devices and translate 
logical block numbers to physical disk addresses. 

A storage retrieval device, such as disk or DECtape, which con- 
tains a file describing the layout of stored data (programs and other 
files). 

A UFD that is distributed over the file structures on which the user 
can read or write. 

A file structure that is physically mounted but has no current users, 
i.e., the mount count is zero. 

Description of a sharable high segment kept on swapping space, and 
possibly core, which is in no user's addressing space. 

The generic device name for disk-like devices (e.g., drums, disk, 
disk packs). Actual file structure names are defined for each job 
by the file structure search list. 

A listing of all variables and their values or a listing of the values 
of all locations in core. 

The logical arrangement of 128-word blocks on one or more units 
of the same type to form a collection of named files. Public file 
structures are given a name for use by all users and are always on 
the system. Private file structures are intended to be mounted and 
dismounted from the system. 

A table, organized by jobs, that specifies the search order for the 
file structures the user can access. 

A device on which data is given names and arranged into files; the 
device also contains directories of these names. 

A one- to six-alphanumeric character name chosen by the user to 
identify a file. 

One to three alphanumeric characters usually chosen to describe the 
class of information in a file. 

The routine that interprets and operates on the file structure, pro- 
cesses disk UUOs, queues disk requests, and makes optimization 
decisions. 
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Fragmentation 
Group 

High Segment 
Home Block 

HOME. SYS 

Idle Segment 

Idle Time 
Impure Code 
ISW Block 

Job 

Job Data Area 

Job Search List 
Latency 



Locked Job 
Lost Time 



Low Segment 



The term applied to swapped segments, which cannot be allocated 
in one contiguous set of blocks on the swapping space. 

A contiguous set of clusters allocated as a single unit of storage, 
and described by a single retrieval pointer. 

The segment of the user's core that generally contains pure code, 
and that can be shared by other jobs; it is usually write-protected. 

The block written on every unit, which identifies the file structure 
the unit belongs to and its position on the file structure. This block 
specifies all the parameters of the file structure and the location of 
the MFD. The home block appears in the HOME. SYS file. 

The file that contains a number of special blocks for system use. 
These blocks are the home blocks, the BAT blocks, the ISW blocks, 
and block zero. 

A sharable high segment that no users in core are using; however, 
at least one swapped-out user is using it; otherwise, it would be a 
dormant segment. 

The percent of uptime in which no job wanted to run, i.e., all 
jobs were HALTed or were in a wait for some device. 

The code that is modified during the course of a run (e.g. , data 
tables). 

A block written by the refresher, which contains the bit map for 
the initial storage allocation table for swapping. Any bad regions 
are marked as already in use. The ISW block appears in the 
HOME. SYS file. 

The succession of user programs run from log in to log out for a 
single user; a process. 

The first 140 octal locations of a user's core area. This area pro- 
vides storage for items used by both the monitor and the user 
program . 

See File Structure Search List. 

a. The time for initiation of a transfer operation to the beginning 
of actual transfer (i.e., verification plus search time). 

b. The time delay while waiting for a rotating memory to reach 
a given location as desired by the user. The average latency 
is one half the revolution time. 

A job in core that is never a candidate for swapping or shuffling . 

The percent of uptime that the null job was running but at least 
one other job wanted to run (i .e. , was not waiting for a device) 
but could not because one of the following was true: 

1) the job was being swapped out. 

2) the job was being swapped in. 

3) the job was on disk waiting to be swapped in. 

4) the job was momentarily stopped so devices could become 
inactive in order to shuffle job in core. 

The segment of core containing the job data area and I/O buffers. 
This area is unique and accessible to the user and is often used to 
contain the users' program. If the user is working with a shared 
program, this area contains data tables. 
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MAINT. SYS 
Memory Protection 

MO NG EN Time 
Monitor 

Multiprocessing 
Mu I ti prog ramm i ng 
Named File 
Nondirectory Device 
Nonsharable Segment 

ONCE ONLY Time 
Pack ID 

Passive Search List 
Peripheral Equipment 

Physical Unit Name 

Pointer 
Pool 

Position Operation 



The area of the disk reserved for maintenance use. 

A scheme for preventing access to certain areas of storage for 
reading or writing. 

The time at which the monitor is loaded because of new equipment 
being added. Therefore the hardware configuration must be 
changed. 

The specific program that schedules and controls the operation of 
several routines, performs overlapped I/O, provides context 
switching, and allocates resources so that the computer is efficient- 
ly used. 

The simultaneous execution of two or more computer programs by a 
computer . 

A technique that allows scheduling so more than one job is in an 
executable state at any one time. 

A named collection of 36-bit words (instructions/data). Length is 
not restricted by size of core. 

A device (e.g., magnetic tape or paper tape) that does not contain 
a file describing the layout of stored data. 

A segment for which each user has his own copy. Nonsharable 
segments never have names even if initialized from a file; they 
may be created by a core or REMAP UUO. 

The time at which the operator may change file structure and disk 
unit parameters. 

A 6-character SIXBIT name or number used to uniquely identify 
a disk pack. This name is appended to the physical device list 
of the monitor. 

An unordered list of the file structures the job can access explicit- 
ly. Device DSK is not defined by this list. 

In a data processing system, any unit of equipment distinct from the 
central processing unit, which may provide the system with outside 
communication. 

The SIXBIT name, consisting of three characters and a digit, which 

is associated with each unit. 

Examples: FHAO, FHA1 , MDAO, MDA1, DPAO, DPA7. 

The location containing an address rather than data, which is used 
in indirect addressing. 

One or more logically complete file structures that provide file 
storage for the users and that require no special action on the part 
of the user. 

The operation of moving the read-write heads of a disk to the 
proper cylinder prior to a data transfer. This operation requires 
the control for several microseconds to initiate activity, but does 
not require the channel or memory system. 
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Private Disk Pack 

Privileged Program 

Priority Interrupt 
Program Break 

Programmed Operators 

Public Disk Pack 

Pure Code 

QUOTA. SYS 

Random Access 

Read 
RECOV. SYS 

Reentrant Program 

Refresh 

Relocate 

Restore 

Retrieval Information Block 
(RIB) 

SAT. SYS 
Search 



a. A self-contained DEC file structure either single- or multi-job 
access . 

b. A disk pack (always single-job access) from another company, 
not certified, or certified but never refreshed. 

a. Any program running under project number 1, programmer 
number 2. 

b. A monitor support CUSP executed by a monitor command and, 
therefore, has the JACCT (fob status bit) set (e.g., LOGOUT). 

The interrupt that usurps control of the computer program or system 
and jumps the sequencing to another device or program. 

The length of a program; the first location not used by a program 
(before relocation); the relocation constant for the program (after 
relocation) . 

Instructions, which, instead of doing computation, cause a jump 
into the monitor system at a predetermined point. The monitor in- 
terprets these entries as commands from the user to perform specified 
operations. 

A disk pack belonging to the storage pool with storage available to 
all users. 

Code that is never modified in the process of execution; therefore, 
it is possible to let many users share the same copy of a program. 

The file that contains a list of users and their quotas for the private 
file structure on which the file resides. 

A device in which the access time is effectively independent of the 
location of the data. 

To open a file for input. 

The file used only for disk crash recovery; temporary information is 
stored in this file when the disk is salvaged in place. 

A two-segment program composed of a sharable and nonsharable 
segment. 

To remove files from a unit and write just a MFD, a few UFDs, a 
SAT. SYS, a HOME. SYS, and a few system files on the disk. 

To move a routine from one portion of storage to another and to ad- 
just the necessary address references so that the routine can be exe- 
cuted in its new location. 

To copy a file previously dumped on magnetic tape back onto disk. 

The block that contains pointers to all the groups in the file. Each 
file has two copies of the RIB, the first block of the first group and 
the block following the last data block in the last group of the file. 

This file is the Storage Allocation Table file and contains a bit for 
each cluster in the file structure. Clusters which are free are in- 
dicated by zero and clusters which are bad, allocated, and non- 
existent are indicated by one. 

The second step in the transfer operation, the controller reads 
sector headers to find the correct sector. 
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Search List 
Sharable Segment 
Shared Code 
STRLST.SYS 

Supersede 



Super-Cluster 

Swapping 

Swapping Class 

SWAP. SYS 
Total User Core 

Transfer Operation 

Trap 
Unit 

Update 

User 
User Mode 



User Program 
Verification 

Vestigial Job Data Area 



See File Structure Search List. 

A segment which can be used by several users at a time. 

Pure code residing in the high segment of user's core. 

The file that describes each file structure in the system. This file 
is used by the MOUNT command only. 

To open a file for writing, write the file, and close the file two or 
more times. Only one user at a time may supersede a given file 
at any one time. The older copy of the file is deleted when all 
users are finished reading it. 

A contiguous set of one or more clusters introduced to compress the 
file pointer for large units into 18 bits (see Compressed File 
Pointer). 

The movement of program sections between core and secondary 
storage. 

The classes of swapping units divided according to speed. Class 
contains the fastest swapping units. 

The file containing the swapping area on a file structure. 

The amount of physical core which can be used for locked and un- 
locked jobs. 

The operation of connecting a channel to a controller and a con- 
troller to a unit from passing data between the memory and the unit. 
The transfer operation involves verification, search, and actual 
transfer. 

An unprogrammed conditional jump to a known location, auto- 
matically activated by hardware. The location from which the 
jump occurred is recorded. 

The smallest portion of a device that can be positioned independent- 
ly from all other units (e.g., a Burroughs disk, a side of the Bryant 
disk, a disk pack, and a drum ). 

To open a file for reading and writing simultaneously on the same 
software channel, rewrite one or more blocks in place, and close 
the file. Only one user at a time may update a given file. 

A person at a terminal . 

A hardware-defined state during which instructions are executed 
normally except for both I/O and HALT instructions, which cause 
immediate jumps to the monitor. This makes it possible to prevent 
the user from interferring with other users or with the operation of 
the monitor; memory protection and relocation are in effect so that 
the user can modify only his area of core. 

All of the code running under control of the monitor in an address- 
ing space of its own . 

The first step in the transfer operation. The controller reads sector 
headers to see if the mechanical parts of the system have correctly 
positioned the arm. 

The first ten octal locations of the high segment used to contain 
data for initializing certain locations in the job data area. 
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Virtual Core The amount of core space that the user appears to be able to use. 

This area is usually handled by a program that allows the currently 
referenced parts of the program to be in core at one time, with 
additional information being retrieved from storage as needed. 

1-4. UFD The UFD of device SYS. The UFD number should be obtained via 

the DEVPPN UUO. 

1-1 . UFD The master file directory, which contains all UFD files (including 

itself) as directory entries. The filename is in octal and, therefore, 
is right justified in each half word. This file is created at refresh 
time. 
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Absolute address, 3-1 

Access blocks, 6-20 

Access protection, 6-16 

Accumulators, 3-2 
| ACTIVATE UUO, 4-12 

Active search list, 6-23 

Activate swapping list, 7-3 

ALCFILCUSP, 2-42 

Algorithms, 7-1 

APPRENB UUO, 4-7, 4-15 

APRTRP mnemonic, 8-10 

ASSIGN command, 2-8 
| ASSIGN SYS command, 2-100 

Asterisk construction, 2-30 

ATTACH job command, 2-81 
I ATTACH dev command, 2-102 

B 

Bad Allocation Table (BAT) block, 7-8 

BITS mnemonic, 8-10 

BLKADR mnemonic, 8-10 

BLKRW subroutine, 8-19 

Block mode, 8-8 

Buffered data modes, 4-48, 4-57 

Buffer header, 4-48 

Buffer initialization, 4-51 

Buffer structure, 4-49 

Buffer ring , 4-50 

Buffer ring header block, 4-49 



CALL and CALLI programmed operators, 4-5 
Card codes, 5-3 



Card punch, 5-2 
concepts, 5-2 
data modes, 5-2 
file status, 5-5 

Card reader, 5-5 
concepts 5-6 
data modes, 5-6 
file status, 5-7 

CCO NT command, 2-79 

Central processor flags, 4-15 

Change of unit pointer, 1-2 

Changing job search list, 4-26 

Changing magnetic tape modes, 5-17 

Changing protections of a file, 6-18 

Channel command chaining, 7-7 

Channel interrupt routines, 7-9 

CHGPPN UUO, 4-12a, 4-28 

CHKACC UUO, 4-12a, 6-34 

CLOSE command, 2-18 

CLOSE UUO, 4-5, 4-61 

Cluster address, 1-1 

Cluster count, 1-1 

Clusters, 6-14 

CNFTBL table, 4-34, 4-35 

Command arguments, 2-3 

Command files, 2-51 

Command format, 2-2 

Command names, 2-3 

Commands, 

ASSIGN, 2-8,2-100 
ATTACH, 2-81, 2-102 
CCO NT, 2-79 
CLOSE, 2-18 
COMPILE, 2-47 
CONT, 2-68 
CORE, 2-21 
CREATE, 2-25 
CREF, 2-46 
CSTART, 2-79 
CTEST, 2-103 
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D, 272 

DAYTIME, 2-86 
DDT, 2-69 
DEASSIGN, 2-1 1 
DEBUG , 2-50 
DELETE, 2-44 
DETACH, 2-80, 2-101 
DIRECT, 2-33 
DISMOUNT, 2-16 
DSK, 2-96 

E, 2-71 
EDIT, 2-26 
EXECUTE, 2-49 
FILE, 2-37 
FINISH, 2-17 
GET, 2-64 
HALT, 2-67 
INITIAL, 2-7 
JCONT, 2-68a 
KJOB, 2-83 
LIST, 2-31 
LOAD, 2-48 
LOGIN, 2-5 
MAKE, 2-27 
MOUNT, 2-13 
PLEASE, 2-19 
PJOB, 2-78 

R, 2-63 

RALCFIL, 2-42 
R DMPFIL, 2-35 
REASSIGN, 2-12 
REENTER, 2-70 
RENAME, 2-45 
RESOURCES, 2-23 
R FILEX, 2-39 
R GRIPE, 2-22 
R LOOK FL, 2-34 
R QUOLST, 2-89 
R PRINT, 2-32 
RSETSRC, 2-41 
RUN, 2-61 
SAVE, 2-73 
SCHEDULE, 2-87 
SEND, 2-18c 
SET CDR, 2- 18a 
SET CORMAX, 2-104 
SETCORMIN, 2-105 
SET DATE, 2-103 
SET DAYTIME, 2-99 
SET SCHEDULE, 2-99 
SET SPOOL, 2-18b 



Commands (Cont) 
SET TIME, 2-105 
SETTTY, 2-97 
SET WATCH, 2-90 
SSAVE, 2-74 
START, 2-66 
SYSTAT, 2-92 
TECO, 2-28 
TIME, 2-88 
TYPE, 2-30 

Comments, 2-2 

Compilation commands, 2-47 

Compilation listings, 2-54 

COMPIL CUSP, 2-24, 2-51 

COMPILE command, 2-47 

Compile switches, 2-54 

Completion of commands, 2-4 

Compressed file pointer, 6-15 

J COMTAB table, 4-35 

CON ECT subroutine, 8-18 

Configuration information, 4-39 
DSKCHR, 4-42 

CONSO skip chain, 7-10 

I Console - initiated traps, 4- 16a 

Consoles, 2-1 

CONT command, 2-68 

Control -C, 2-2 

Core allocation resource, 8-4 

Core area, 3-4 

CORE command, 2-21 

Core control, 4-17 

Core storage, 3-3 

Core storage check, 2-4 

CORE UUO, 4-6, 4-17 

CORMAX, 8-1 

CORMIN, 8-1 

CORTAB table, 4-35 

CREATE command, 2-25 
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Creating new job search list, 4-26 
CREF command, 2-46 
CSTART command, 2-79 
CTEST command, 2-103 
CTLJOB UUO, 4-12, 5-38 
CUSP command level, 1-4 
CUSP I/O level , 1-4 



Data channel, 4-47 

Data errors, 7-8 

Data modes, 4-47 

Data transmission, 4-56 

DATE UUO, 4-7, 4-30 
| DAYTIME command, 2-86 

D command, 2-72 

DDT command, 2-69 

DDTsubmode, 5-28 
| DEACTIVATE UUO, 4-12 

DEASSIGN command, 2-11 

DEBUG command, 2-50 

Debugging reentrant CUSPs, 2-77 

DECtape, 6-2 
data modes, 6-2 
format, 6-3 
I/O programming, 6-6 
UUOs, 6-6, 6-10 
file status, 6-11 
important considerations, 6-12 

DECtape block allocations, 6-5 

DECtape compatibility, A-l 

DECtape directory format, 6-3 

DECtape file format, 6-5 

DECtape format, 6-3 

DECtape I/O programming, 6-6 

DECtape parameter block, 6-6 

Delayed command execution, 2-4 



DELETE command, 2-44 

DETACH command, 2-80 

| DETACH dev command, 2-101 

Detached job, 2-78 

Determining physical characteristics of 
devices, 4-39 

DEVCHR UUO, 4-6, 4-39 
I DEVGEN UUO, 4-12a 

Device errors, 7-8 

Device initialization, 4-47, 4-55 

Device optimization, 7-5 

Device selection, 4-46 

Device status bits, D-l 

Device termination, 4-63 
J DEVNAM UUO, 4-12 

DEVPPNUUO, 4-11,4-41 
I DEVSIZ UUO, 4-12a, 4-44a 

DEVSTSUUO, 4-11,4-39,6-11, 6-34 
I DEVTYP UUO, 4-11, 4-44 

Diagnostic messages, 2-29, F-l 

Digital compatible mode, 5-16 

DIRECT command, 2-33 

Directory algorithms, 7-9 

Directory devices, 6-1 

Directory searches, 7-9 

Direct user I/O, 8-21 

DISCON subroutine, 8-18 

DISK 

data modes, 6-13 

directories, 6-14 

file status, 6-36 

file structure names, 6-20 

job search list, 6-23 

protection, 6-16 

quotas, 6-19 

RIB, 6-16 

structure of files, 6-13 

UFD privileges, 6-19 

User programming, 6-24 
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Disk monitor, 1-1 

Disk packs, 6-37 

identification, 6-37 
compatibility, 6-38 

Dismissing an interrupt 8-13 

DISMOUNT command, 2-16 

Display with light pen, 5-7 
data modes, 5-8 
file status, 5-10 
UUOs, 5-8 

DMPFIL CUSP, 2-35 

Dormant segments, 7-3 

DSKCHRUUO, 4-10, 4-42 

DSK command, 2-96 

Dump output, 4-57 



E command, 2-71 

EDIT command, 2-26 

End of file card 
card punch, 5-2 
card reader, 5-6 

ENTER UUO, 4-5, 4-52 
error codes, E-l 
DECtape, 6-7 
disk, 6-26, 6-28 

Environmental information, 4-29 

EOF pointer, 1-2 

Error codes, E-l 

Error handling, 3-2, 7-8 

Error intercepting, 4-16 

Error messages, 2-29, F-l 

EXECUTE command, 2-49 

Execution control, 4-13 

Executive mode, 4-2 

EXIT UUO, 4-7, 4-14 

Extended command forms, 2-51 
indirect commands, 2-51 
+ construction, 2-52 
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= construction, 2-53 
<> construction, 2-53 

Extended LOOKUP, ENTER, RENAME, 6-28 

Extensions, 2-24, G-l 



Facility allocation command, 2-7 

Fairness considerations, 7-7 

FILE command, 2-37 

FILE directories, 1-6, 6-14 

FILE manipulation, 2-29 

Filename extension, 2-24, G-l 

Filenames, 2-24 

File reading, 4-64 

Files, 1-7, 4-45 

File selection, 4-52 

File specification, 2-30 

File status bits, 4-61 

File structure control, 4-25 

File structure directories, 6-14 

File structure names, 6-20 

File structures, 1-6 

File termination, 4-61 

File writing, 4-64 

FILEX CUSP, 2-39 

Filler characters, 2-95 

FILSER, 6-14, 7-5 

FINISH command, 2-17 

Folded checksum, 7-8, 1-1 

Forced compilation, 2-56 

.FSSRC (STRUUO), 4-26 

FORTRAN real-time subroutines, 8-17 

FORTRAN usage of real-time trapping, 8-17 

FRECHN UUO, 4-11 

Full duplex Teletype service, 5-24 
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GET command, 2-64 

GETLIN UUO, 4-8, 4-30 

GETPPN UUO, 4-8, 4-30 

GETSEG UUO, 4-9, 4-22 
error codes, E-1 
sequence of operations, 4-21 

GETSTS UUO, 4-4, 4-60 

GETTAB UUO, 4-9, 4-33 

GOBSTRUUO, 4-12, 4-31 

GRIPE CUSP, 2-22 

Group pointer, 1-1 

H 

Half-duplex Teletype service, 5-26 

HALT command, 2-67 

HALT(JRST4,),4-14 

Hard error, 7-8 

Hardware detected errors, 7-8 

Header card 

card punch, 5-2 
card reader, 5-6 

| HIBER UUO, 4-12, 4-16b 

High segment, 3-1 

HISEG pseudo-op, 3-10 
|HPQUUO,4-12, 8-24 

H switch, 3-8 

I 

Idle segment, 7-3 
Illegal instructions, 4-14 
Illegal operation codes, 4-13 
Implicit RESET, 8-4 
Impure code, 1-2 
Impure segment, 1-6 
INBUF UUO, 4-4, 4-51 



Indirect commands, 2-51 

Industry compatible mode, 5-17 

INITIAL command, 2-7 

Initial file status, 4-47 

INIT UUO, 4-3, 4-47 

Input handling of Teletype control characters, 
5-24 

INPUT UUO, 4-4, 4-56 

I Inter-program communication, 4-28a 

Interrupt chains, 7-10 

IOACT, 4-61 

IOBKTL, 4-61 

IODERR, 4-61 

IODTER, 4-61 

IOEOF, 4-61 

IOIMPM, 4-61 

I/O organization, 4-45 

I/O programming, 4-45 



JBTADR table, 4-34 
JBTCNO table, 4-35 
JBTDBS table, 4-34 
JBTDEV table, 4-35 
JBTKCT table, 4-34 
JBTLIM table, 4-35 
JBTLOC table, 4-35 
JBTNM1 table, 4-35 
JBTNM2 table, 4-35 
JBTPRG table, 4-34 
JBTPRV table, 4-34 
JBTQ table, 4-35 
JBTRCT table, 4-34 
JBTRTD table, 4-35 
JBTSGN table, 4-34 
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J JBTSPL table, 4-35 
JBTSTS table, 4-34 
JBTSWP table, 4-34 
JBTTDB table, 4-34 

IJBTTMP table, 4-35 
JBTWCH table, 4-35 

JBTWCT table, 4-34 
J JCONT command, 2-68a 

Job, 7-1 

JOBAPR, 3-6 

JOBBLT, 3-5 

JOBCHN, 3-7 

JOBCNI, 3-6 

JOBCN6, 3-5 

JOBCOR, 3-7 

JOBDA, 3-7 

Job Data Area, 3-4 

JOBDDT, 3-5 

JOBERR, 3-5 

JOBFF, 3-6 

JOBHCR, 3-10 

JOBHDA, 3-11 
|jOBHGH, 3-10 

JOBHRL, 3-5 

JOBHRN, 3-10 

JOBHSA, 3-10 

JOBHVR, 3-11 

JOBH41, 3-10 

Job initialization commands, 2-4 

Job X/O initialization, 4-46 
| JOBINT, 3-7, 4-16 

Job number check, 2-3 

JOBOPC, 3-6 

JOBPFI, 3-5 

JOBREL, 3-5 



JOBREN, 3-6 

Jobs, 2-1 

JOBS A, 3-6 

Job scheduling, 1-1, 7-1 

Job search list, 6-23 

Job state codes, 4-38 

Job status information, 4-30 

JOBSTRUUO, 4-10, 4-31 

JOBSTSUUO, 4-11,5-37 

JOBSYM, 3-6 

Job termination, 2-82 

JOBTPC, 3-6 

JOBUSY, 3-6 

JOBUUO, 3-5 

JOBVER, 3-7 

JOB41, 3-5 



K 



KJOB command, 2-83 



Latency time, 7-5 

Library searches, 2-57 

Line printer, 5-1 1 
data modes, 5-11 
file status, 5-11 

LIST command, 2-31 

Listing files, 2-54 

LOAD command, 2-48 

Loader, 3-7 

Loader maps , 2-57 

Loader switches, 2-58 

Loading user core area, 3-4, 3-9 

LOCATE UUO, 4-12 

Location counter, 3-8 

LOCK subroutine, 8-17 
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LOCKUUO, 4-11, 8-2 

Logged-in quota, 1-7, 6-19 

Logged-out quota, 1-7, 6-19 

Logical device names, 2-8 
suppression of, 4-1 2b 

Logical unit names, 6-21 

Login check, 2-3 

LOGIN command, 2-5 

LOGIN UUO, 4-7, 4-27 

LOGOUT UUO, 4-7, 4-15 

LOOKFL CUSP, 2-34 

LOOKUP UUO, 4-5, 4-52 
error codes, E-l 
DECtape, 6-6 
disk, 6-27, 6-28 

Low segment, 3-1 

LVDTBL table, 4-34, 4-37 

M 

Magnetic tape, 5-12 
data modes, 5-12 
file status, 5-18 
format, 5-13 
UUOs, 5-13 

MAKE command, 2-27 

MAP program , 7-8 

Master file directory, 1-6, 6-14 

Meddling, 4-24 

Memory fragmentation, 8-3 

Memory parity error recovery, 3-2 

Memory protection and relocation, 1-2, 3-1 

Memory relocation register, 1-2, 3-1 

MFD, 1-6, 6-14 

Modifying shared segments, 4-24 

Monitor capabilities, 1-1 

Monitor command interpreter, 1-4, 2-1 

Monitor command level, 1-4 

Monitor examination, 4-32 



Monitor functions, 1-1 

Monitor generated buffers, 4-51 

Monitor mode, 2-1 

Monitor sizes, B-l 

Monitor UUOs, 4-3 
table, 4-3 

CALL and CALLI table, 4-6 
restrictions in reentrant programs, 4-12b 

MOUNT command, 2-13 

MSTIME UUO, 4-8, 4-30 

MTAPE functions, 5-14 

MTAPE UUO, 4-5, 5-14, 6-10 

Multiprogramming, 1-1 

N 

Named file, 1-7 
Nine-channel magtape, 5-16 
Nondirectory devices, 5-1 
Non-reentrant program, 1-6 
Non-sharable segments, 1-5 
NSWTBL table, 4-34, 4-36a 
NUMTAB table, 4-35, 4-37 



Obtaining project-programmers associated 
with device, 4-41 

ODPTBL table, 4-34, 4-37 

Offset, 3-8 

Once -only parameters, J-l 

OPEN UUO, 4-4, 4-47 

Optimization 7-5 

Order of directory filenames, 7-9 

OTHUSR UUO, 4-12a, 4-32 

OUTBUF UUO, 4-4, 4-50 

OUTPUT UUO, 4-5, 4-56 

Overdrawn (quotas), 6-20 

Owner of files, 6-18 
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Paper tape punch, 5-19 
data modes, 5-19 
file status, 5-20 

Paper tape reader, 5-20 
data modes, 5-20 
file status, 5-21 

PARADR, 3-3 

Parity error, 3-2 

PARPC, 3-3 

PARSPR, 3-3 

PARTOT, 3-3 

Passive search list, 6-23 

Password, 2-4 

PEEK UUO, 4-8, 4-32 

Permanent switch, 2-54 

Physical controller class names, 6-21 

Physical controller names, 6-21 

Physical device names, 2-8 

Physical unit names, 6-21 

PICHL mnemonic, 8-10 

PJOB command, 2-78 

PJOB UUO, 4-8, 4-30 

PLEASE command, 2-19 

Plotter, 5-22 

data modes, 5-22 
file status, 5-23 

Position-done interrupt, 7-7 

Positioning, 7-5 

PRINT CUSP, 2-32 

Priority Interrupt routines, 7-9 

Privileged programs, 6-19 

PRJPRG table, 4-34 

Processor modes, 4-1 

Processor switches, 2-57 

Program identification, 4-27 

Program operators, 4-2 



Program origin, 3-8 

Project-programmer numbers, 2-4 

Protection address, 3-1 

Protection codes, 6-18 

Pseudo-Teletype, 5-34 
concepts, 5-34 
file status, 5-36 
SLEEP UUO, 5-35 
UUOs, 5-36 

Pure code, 1-2 

Pure segment, 1-6 

Q 

QQQTAB table, 4-35 
Quantum time, 1-1, 7-2 
Queues, 7-1 
Queuing strategy, 7-6 
QUOLST CUSP, 2-89 
Quotas, 1-7, 6-19 

R 

R command, 2-63 

Reading a UFD, 4-41 

Real-time programming, 8-1 

Real-time trapping, 8-8 
FORTRAN usage, 8-17 

REASSIGN command, 2-12 

REASSIGN UUO, 4-7, 4-64 

REENTER command, 2-70 

Reentrant capability, 1-2, 1-5 

Reentrant program, 1-6, 3-1, C-l 

Relative address, 3-1 

RELEASE UUO, 4-5, 4-63, 5-37 

Relocation address, 3-1 

REMAP UUO, 4-9, 4-23 

Remembered commands, 2-24, 2-47 

Removable file structures, 6-37 
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Removing devices from PI channel, 8-13 

RENAME command, 2-45 

RENAME UUO, 4-4, 4-54 
error codes, E-l 
DECtape, 6-8 
disk, 6-27, 6-28 

RESET UUO, 4-6, 4-46, 6-34 

RESOURCES command, 2-23 

Retrieval Information Block, 6-16 

Retrieval pointers, 1-1 

RIB, 6-16 

Ring buffers, 4-49 

RTINIT subroutines, 8-17 

RTREAD subroutine, 8-19 

RTSLP subroutine, 8-20 

RTSTRT subroutine, 8-18 

RTTRP UUO, 4-11, 8-8 
error codes, 8-1 1 
examples, 8-13 
returns, 8-11 

RTWAKE subroutines, 8-20 

RTWRIT subroutine, 8-19 

RUN command, 2-61 

Run control, 2-60 

RUNTIM UUO, 4-8, 4-30 

RUN UUO, 4-9, 4-19 
error codes, E-l 
sequence of operations, 4-21 



SAT blocks, 6-14 
SAVE command, 2-73 
Saved file format, 2-76 
J SCHEDULE command, 2-87 
Scheduling, 1-1,7-1 
Searching, 7-5 
SEEK UUO, 4-11, 6-34 
Segment control , 4-19 



Segments, 1-2, 1-5 

Sequence of RUN UUO operations, 4-21 

SEND command, 2-18c 

SET CDR command, 2-18a 

SET CORMAX command, 2-104 

SET CORMIN command, 2-105 

SET DATE command, 2-103 

SET DAYTIME command, 2-99 

SETDDT UUO, 4-6, 4-13 

SETNAM UUO, 4-10, 4-27 

I SET SCHEDULE command, 2-99 
SET SPOOL command, 2-18b 
SETSRC CUSP, 2-41 
SETSTS UUO, 4-4, 4hS0 
SET TIME command, 2-105 
SET TTY command, 2-97 
SETUUO, 4- 12a, 4-28 
SETUWP UUO, 4-9, 4-18 
j SET WATCH command, 2-90 
SHARABLE segments, 1-5, 4-23 
Simultaneous access, 6-20 
Simultaneous supersede, 6-34a 
Single mode, 8-8 

SLEEP UUO, 4-8, 4-16a 
PTY, 5-35 

Soft error, 7-8 

Software detected errors, 7-8 

Software states, 7-6 

Source file preparation, 2-24 

J Spooling of I/O on disk, 6-38 

SPY UUO, 4-9, 4-32a 

SSAVE command, 2-74 

Standard processor, 2-55 

START command, 2-66 

Starting a program, 4-13 

State Codes, 4-38, 7-5 
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STATI subroutine, 8-20 

STATO subroutine, 8-19 

STATOUUO, 4-4,4-60 

Status checking, 4-60 

Status information (DSKCHR), 4-42 

Status setting, 4-60 

STATZ UUO, 4-4, 4-60 

Stopping a program, 2-2, 4-14 

Storage Allocation Table, 6-14 

Structure of disk files, 6-13 

STRUUO UUO, 4-10, 4-25 

STSTBL table, 4-35,4-38 

Subroutine to input one character, 4-58 

Subroutine to output one character, 4-59 

Super cluster, 6-15 

Super - USETI, 6-33 

Super - USETO, 6-33 
I Suppression of logical device names, 4-12b 

Suspending, 4- 16a 

Swapping, 1-2, 7-3 

Swapping allocator, 7-4 

Swapping classes, 7-4 

Swapping space, 7-3 

SWAP .SYS, 7-3 

Switches (COMPIL), 2-54, 2-57 

SWITCH UUO, 4-7, 4-39 

SWPTBL table, 4-34, 4-36a 

Synchronization of buffered I/O, 4-59 

SYSPHYUUO, 4-11, 4-45 

SYSSTRUUO, 4-10,4-44b 
|SYSTAT command, 2-92 

System administration, 2-95 

System library, 6-16 



TECO command, 2-28 



Teletype, 5-23 
data modes, 5-24 
control characters, 5-24 
DDT submode, 5-28 
file status, 5-32 
TTCALL, 5-29 
paper tape input, 5-33 
paper tape output, 5-34 

Teletype characteristics command, 2-93 

Temporary files, 2-59 

Temporary switch, 2-54 

Testing sharable segments, 4-23 

TIME command, 2-88 

TIMER UUO, 4-7, 4-30 

Timing and usage, 2-84 

Timing information, 4-29 

TMPCOR UUO, 4-10, 4-28a 

Total user core, 8-1 

Transfer-done interrupt, 7-7 

Trapping, 4-15 

console-initiated traps, 4-16 

TRPADR mnemonic, 8-10 

TRPJEN UUO, 4-8 

TRPSET UUO, 4-8, 4-65, 8-21 

TTCALL UUO, 4-4, 5-29 

TTIME table, 4-34 

TTYTAB table, 4-34 

TYPE command, 2-30 

U 

UFD, 1-6, 6-14 

UFD privileges, 6-19 

UGETF UUO, 4-5, 6-10 

UJEN, 8-23 

Unit selection on output, 6-22 

Unit states, 7-4 

Unbuffered data modes, 4-48, 4-56 

Unimplemented op codes, 4-13 
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Unlocking jobs, 8-4 

Use bit, 7-2 

User facilities, 1-3 

User file directory, 1-6, 6-14 

User generated buffers, 4-51 

User I/O mode, 4-1 

User mode, 2-1, 3-1, 4-1 

User programming, 4-1 

User programming for the disk, 6-24 
4-word arguments, 6-25 
extended arguments, 6-28 

User UUOs, 4-2 

USETI UUO, 4-5, 6-10, 6-33 

USETO UUO, 4-5, 6-10, 6-33 

UTPCLRUUO,4-7, 6-10 

UUOs, 4-2 
user, 4-2 
monitor, 4-3 

V 

Verification, 7-5 

Vestigial job data area, 2-77, 3-10 

Virtual core, 7-3 

W 

WAIT UUO, 4-6, 4-59 

WAKE UUO, 4-12, 4-16c 

WHERE UUO, 4-12 

Writing reentrant user programs, C-l 

Z 
Zero - Compressed files, 2-75 
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